[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