Re: GnuPG website docs

2020-01-15 Thread David Eisner via Gnupg-users 
On Mon, Jan 13, 2020 at 3:55 AM Werner Koch  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
___
Gnupg-users mailing list
Gnupg-users@gnupg.org
http://lists.gnupg.org/mailman/listinfo/gnupg-users

GnuPG website docs

2020-01-10 Thread David Eisner via Gnupg-users 
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
___
Gnupg-users mailing list
Gnupg-users@gnupg.org
http://lists.gnupg.org/mailman/listinfo/gnupg-users