[OpenAFS-Doc] documentation priorities

Jason Edgecombe jason@rampaginggeek.com
Mon, 18 May 2009 21:56:21 -0400


Russ Allbery wrote:
> Steven Jenkins <steven.jenkins@gmail.com> writes:
>
>   
>> Given the recent progress made with respect to the Quick Start Guide
>> and the man pages, could someone (Russ?  Jason? Jeff?) summarize what
>> our priorities are?  i.e., what is the biggest need that we should
>> tackle next.
>>     
>
> I think the biggest need right now is revision of the DocBook
> documentation.  The man pages are now in fairly good shape -- there's
> work to be done, but they mostly reflect reality.  Work on the Quick
> Start Guide has mostly just started, and the other manuals have I think
> basically not been touched and are horribly out of date in spots.
>   
I agree with Russ. I'm tired of seeing the new people following the 
outdated guide, setting up kaserver, and getting
 told they did the wrong thing on the mailing list.

Jason