From nobody Mon Dec 27 17:46:36 2021 X-Original-To: freebsd-questions@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 919DD1915D1C for ; Mon, 27 Dec 2021 17:46:39 +0000 (UTC) (envelope-from list_freebsd@bluerosetech.com) Received: from echo.brtsvcs.net (echo.brtsvcs.net [IPv6:2607:f740:c::4ae]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4JN4q33Hrgz3PDR; Mon, 27 Dec 2021 17:46:39 +0000 (UTC) (envelope-from list_freebsd@bluerosetech.com) Received: from chombo.houseloki.net (unknown [IPv6:2602:41:642b:600::6]) by echo.brtsvcs.net (Postfix) with ESMTPS id 85DDA38D20; Mon, 27 Dec 2021 17:46:38 +0000 (UTC) Received: from [10.26.25.100] (ivy.pas.ds.pilgrimaccounting.com [10.26.25.100]) by chombo.houseloki.net (Postfix) with ESMTPSA id AC1D5173C5; Mon, 27 Dec 2021 09:46:37 -0800 (PST) Subject: Re: Is the old format documention still available? To: Sergio Carlavilla Cc: freebsd-questions@freebsd.org References: <2d4cc2be-524b-a3cf-fdfe-2c0df4258a0e@bluerosetech.com> From: Mel Pilgrim Message-ID: <30dcef72-9bfd-6b68-bac7-980f7b907b1e@bluerosetech.com> Date: Mon, 27 Dec 2021 09:46:36 -0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.12.0 List-Id: User questions List-Archive: https://lists.freebsd.org/archives/freebsd-questions List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-questions@freebsd.org X-BeenThere: freebsd-questions@freebsd.org MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 4JN4q33Hrgz3PDR X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-Spam: Yes X-ThisMailContainsUnwantedMimeParts: N On 2021-12-27 8:50, Sergio Carlavilla wrote: > On Mon, 27 Dec 2021 at 17:34, Mel Pilgrim wrote: >> >> How do I access the old format of the documentation? The new format has >> major regressions that make it inaccessible. The old format wasn't >> perfect, but it worked for screen-reading, mouseless nav, and mobile >> browsers. The new format isn't compatible with any of that due to how >> the sidebars take priority over the section content. >> > > Hi Mel, > > No, the old format it's not accessible, at least not with the last version. > > Why don't you like it? We need to fix some things from the navigation. > But if you give me your feedback it would be good to improve the website. The desktop site is insufficiently responsive. The sidebars take up 2/3 of the horizontal screen space on a mobile browser. I use the "desktop site" because the "mobile" version does not render correctly on Firefox Android. Because chapters load as monolithic pages instead of splitting sections into separate pages, the handbooks are extremely slow to load. If I click a section link that isn't the first or last section of a chapter, the page will scroll as the entire chapter loads. Mouseless navigation doesn't work because the sidebar takes priority in the cursor order and cursor position is reset to the sidebar with every page load. Screen-readers are similarly confounded by the sidebars taking precedence. In a full desktop browser, the sidebars cannot be resized, so larger text or long section titles wrap in very strange ways. There are NUMEROUS proofing and formatting errors that did not exist in the old format. Several examples of this is are in just the sidebar of the Porter's Handbook: 7.3.USES=phpand Flavors 7.4.USES=pythonand Flavors 7.5.USES=l u aand Flavors 9.5. SUB_FILESandSUB_L Making Use of 10.1 make Running desc r i be 10.5.PREFIXandDESTDIR 13.6 execStatement in Use Wrapper the scripts There's no option to fully expand the left sidebar, so I can't skim it like a normal index or ToC. The only way for me to use the documentation right now is to download the entire thing as a single HTML file, element-block the ToC, and use text search to find what I need.