[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#51000: The Web manual situation is still needlessly confusing
From: |
Efraim Flashner |
Subject: |
bug#51000: The Web manual situation is still needlessly confusing |
Date: |
Mon, 4 Oct 2021 09:31:59 +0300 |
On Mon, Oct 04, 2021 at 12:12:55AM +0200, Tobias Geerinckx-Rice via Bug reports
for GNU Guix wrote:
> Good evening Guix!
>
> Nary a literal week goes by that someone doesn't post confusion about this
> or that not being in ‘the manual’, where the manual turns out to be
> <https://guix.gnu.org/manual/en/guix.html> instead of the one actually
> shipped with their Guix.
>
> The current solution is pointing them to
> <https://guix.gnu.org/manual/devel/en/guix.html> and resetting the timer.
>
> Instead:
>
> - We should make <https://guix.gnu.org/manual/en/guix.html> the ‘devel’
> version, and move the stable version to to a versioned URL like
> <https://guix.gnu.org/manual/1.3.0/en/guix.html>.
>
> - Both manuals should have a gorgeous CSS box at the very top clearly
> explaining their nature.
Here is an untested patch against guix-maintenance to change the manual
locations. It doesn't take into account any changes needed in the
website itself to add a pointer to the 1.3.0 manual.
--
Efraim Flashner <efraim@flashner.co.il> רנשלפ םירפא
GPG key = A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351
Confidentiality cannot be guaranteed on emails sent or received unencrypted
0001-hydra-Move-guix-manual-URLs.patch
Description: Text document
signature.asc
Description: PGP signature