GNU bug report logs - #51000
The Web manual situation is still needlessly confusing

Previous Next

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Tobias Geerinckx-Rice <me <at> tobias.gr>
To: Bug reports for GNU Guix <bug-guix <at> gnu.org>
Subject: The Web manual situation is still needlessly confusing
Date: Mon, 04 Oct 2021 00:12:55 +0200

[Message part 1 (text/plain, inline)]

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.

Kind regards,

T G-R

[signature.asc (application/pgp-signature, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.