On 11/23/20 11:01 AM, Magnus Hagander wrote:
> I think it requires a silly number of steps to get to our
> documentation today. It's not huge, but it's "click documentation,
> click "current manuals", click 13". And the actual /docs/ page is
> mostly empty, which makes it a waste.
>
> PFA a patch that changes this:
>
> * The /docs/ page now gets direct links to all supported documentation
> versions, including PDFs
>
> * The /docs/ page gets a big button that sends you directly to
> /docs/current/ -- that link wasn't available at all before
I would bikeshed the text on this slightly, perhaps: "Current
Documentation" or "Latest Documentation".
I'd be ok with "View Current Documentation" as well.
>
> * Translated manuals were listed both on the left and right sidebar on
> the root docs page, but not on the manuals page. Remove them from the
> left sidebar, leave them on the right one since it's now on the root
> docs page.
>
> Unrelated to the restructuring, but while at it:
> * Make the left column in the manuals table not take 50% of the width
> when all it has is a number
>
> * Add a link to the developer docs
>
> * Remove the repetitive "comprehensive manual" text (it's no more
> comprehensive than the other manual, it's just a different format),
> and insert a proper separator between the two PDF versions
>
> * Remove some redundant and incorrect template tags probably resulting
> from previous copy/paste mistakes
>
> I'm also attaching a screenshot of the main docs page with the
> changes, for those that can't easily test a website patch. (Nevermind
> the actual versions listed, as this is off a dev version of the
> database and not up to date)
I could not verify the PDF changes as I don't have them built locally at
the moment, but everything else looks fine.
+1,
Jonathan
