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

Previous Next

Full log

View this message in rfc822 format

From: Felix Lechner <felix.lechner <at> lease-up.com>
To: 51000 <at> debbugs.gnu.org
Cc: John Kehayias <john.kehayias <at> protonmail.com>, Tobias Geerinckx-Rice <me <at> tobias.gr>, Efraim Flashner <efraim <at> flashner.co.il>
Subject: bug#51000: Please drop web manuals for released versions
Date: Sun, 21 May 2023 18:59:20 -0700

Hi,

> Here is an untested patch

Guix suffers from an unhelpful anachronism that search engines
consistently rank historical versions of the Reference Manual [1]
above the latest edition. [2] It's probably because third-parties link
to historical versions more often than they do to the current version.
Please drop the historical versions.

Historical versions are irrelevant for current users and should only
be shipped on installation media. The current edition is only a 'guix
pull' away—a command we encourage widely.

As an example for the grave but unnecessary confusion, the manual
generally perceived as official lists the incorrect email address
guix-patches <at> debbugs.gnu.org as a way to contribute to Guix. [3]

Let's not put stumbling blocks before the blind, please. I beg you,
let's think of our fellow human beings. Thanks!

Kind regards,
Felix Lechner

[1] https://guix.gnu.org/manual/en/guix.html
[2] https://guix.gnu.org/en/manual/devel/en/guix.html
[3] https://guix.gnu.org/en/manual/en/guix.html#Multiple-Patches-1

Previous Next

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