[OpenAFS] Why documentation has not kept up with code submissions

Erik Dalén dalen@socialisterna.org
Thu, 21 May 2009 14:13:06 +0200


On Sun, May 17, 2009 at 23:34, Jeffrey Altman
<jaltman@secure-endpoints.com> wrote:
> David Boyes wrote:
>> No, it's not hard in an individual case, but the documentation can't kee=
p up
>> with current development as it is
>
> The primary reason that documentation has not been able to keep up is
> that most of it has been in a form that was not editable.  You may not
> be aware of it but all of the documentation
>
>  * Unix Quick Start Guide
>  * Windows Release Notes / Reference
>  * OpenAFS Reference (man pages for all commands, config files, and
> services)
>  * OpenAFS User Manual
>  * OpenAFS Administrator Manual
>
> is all now in an editable form.  POD files for the OpenAFS Reference
> and DocBook for everything else.

Are docs at http://docs.openafs.org/ going to be updated from the new
documentaion?
Would also be helpful if you could put PDF versions of each document there.

-- 
Erik Dalén