Mailing List Archive

GnuPG website docs
The Documentation pages on gnupg.org should be updated to let users
(especially new users) know which information there is out of date.

Users are encouraged to use GnuPG version 2. Put yourself in the position
of a new user. You visit the Documentation menu on the home page (already a
bit overwhelming -- HOWTOs, Manuals, Guides, ...) and go to HOWTOs. It says
up front, "You may get the best overview about the GnuPG system by reading
the mini HOWTO ..." great. Except that the Mini Howto (in English, at
least) is from 2004, two years before the release of GnuPG 2.0.0. This will
often be the first doc new users will read, and it will be misleading.

1. I think there should be a notice near the top of
https://gnupg.org/documentation/howtos.html that says something like this:
"The mini HOWTO is out-of date and documents an older version of GnuPG. For
more up-to-date documentation, please see ..."

2. "HOWTOs" should be moved to a lower spot in the Documentation menu on
the website.

-David
Re: GnuPG website docs [ In reply to ]
On Fri, 10 Jan 2020 10:48, David Eisner said:

> 1. I think there should be a notice near the top of
> https://gnupg.org/documentation/howtos.html that says something like this:
> "The mini HOWTO is out-of date and documents an older version of GnuPG. For
> more up-to-date documentation, please see ..."

I added some notices but I am not sure what to suggest as replacement.

> 2. "HOWTOs" should be moved to a lower spot in the Documentation menu on
> the website.

Yes, the HOWTOS _used_ to be more useful than the manuals etc.


Shalom-Salam,

Werner

--
Die Gedanken sind frei. Ausnahmen regelt ein Bundesgesetz.
Re: GnuPG website docs [ In reply to ]
On Mon, Jan 13, 2020 at 3:55 AM Werner Koch <wk@gnupg.org> wrote:

>
> I added some notices but I am not sure what to suggest as replacement.
>

Vielen Dank. My guess is that the HOWTOs won't be updated anytime soon, so
this might be the best you can do for the time being.

-David