I want to help improve the documentation.

[Georgiy Treyvus]

Hey Bernhard,

I'm truly happy to be on board. If you think there are places I could be
of better use let me know but all in all I think the best strategy is to
go and improve bit by bit as my time permits the documentation in the
man/info pages.

Partly this is because I think that in any good piece of software the
official manual should be the go to place where all of a user's
questions are simply, clearly, and unambiguously answered. Another
factor to keep in mind is that a user may not always have internet
access and that's why all the critical information should be in the
documentation that comes with GnuPG. Improving the website would be nice
(and I do hope to get around to it) but in my opinion it's no substitute
for a good manual that comes as a part of the software.

I just hope to have a steady stream of incremental improvements to the
man/info pages coming in. Also adding some complexity to the mix are all
the changes that come with GnuPG 2.1.0 which I must first understand
properly to fully see all the holes in the documentation which from
previous precedent there definitely will be. All challenges considered
this is still an awesome opportunity to improve a piece of software that
is critical to preserving everyone's freedom and security. Another
benefit is that in the process I will hopefully wind up knowing the
OpenPGP spec inside out and get that much closer to being a truly
hardcore cryptographer.

Anyway if there is some way you feel I can improve my approach to
improving the documentation let me know. Otherwise I'll just get to work
and hopefully one day GnuPG will be documented so well even my grandma
can use it. Feel free to suggest more specifically how I can be of use.

Best Regards,
Georgiy


On 10/28/2014 09:45 AM, Bernhard Reiter wrote:
> Hi Georgiy,
> 
> On Saturday 18 October 2014 at 21:37:42, Georgiy Treyvus wrote:
>> Please let me know how I can be of help on this front and
>> how to best integrate myself with the overall workflow here.
> 
> welcome as part of the GnuPG Initiative!
> It is great that you want to help, we need all hands that we can get. :)
> 
> There are probably a number of places you could start
> or where you can contribute directly.
> When in doubt, it is always fine to ask here or on gnupg-users 
> on how to progress a thing.
> 
> If you find obvious issues in the documentation coming with gnupg
> just try to create a suggestion and a diff to the latest git-master.
> You can probably use the issue tracker.
> 
> The website also needs help, I currently don't know how Werner organises
> help there.
> 
> In addition I've started wiki.gnupg.org just pick a few TODOs there,
> if you like. E.g. complete the listing of the already familiar types of 
> documentation to get an overview.
> 
> You can also read here or on gnupg-users and try to answer questions by 
> others.
> 
> Best Regards,
> Bernhard
>  
> 
> 
> 
>