AnsweredAssumed Answered

Quantity not quality

Question asked by amcginlay on Apr 7, 2007
Latest reply on May 4, 2009 by berend_tty
There seems to be a lot of documentation, it really doesn't gel together very well though unfortunately. Some of the docs are also clearly out of date.

I am trying to set up NTLM pass through authentication for my users however there is conflicting information on how to do this and I am finding the whole thing very irritating :)

Something that can really make a good project into an _excellent_ project is high quality documentation.. (the consistency and quality of the gentoo handbook is a very good example).  I think the best thing that can be done right now is a complete overhaul of the docs by those who know what they are doing. take everything that currently exists, weed out the rubbish and neaten up everything else! Don't rely on wiki docs but have that as a compliment to the official documentation!

Here is the gentoo handbook as an example of how good documentation should look:

http://www.gentoo.org/doc/en/handbook/handbook-x86.xml

I really hope the situation improves!

Outcomes