Re: Linux docs (was:Re: [tlug] Re: IPv6)

["Stephen J. Turnbull" <turnbull@example.com>]

Scott Robbins writes:

 > So, you feel my reasoning, that it was because their target audience was
 > too buzzed to understand is wrong.

Buzzed or not the original BSD crowd is smart enough to understand. :-)

 > I think a large part of it is attitude.  Many coders, I assume, want to
 > code, not document.  The OpenBSD people, however, are proud of their
 > documentation, and Theo comments that code is never included without
 > proper docs.  Regardless of what one thinks of Theo, it seems the the
 > whole environment, peer pressure, etc., rewards those who document. 
 > 
 > The FreeBSD jail man page is another good example.  Written by one of
 > the nicest of the FreeBSD folks, Robert Watson (incredibly patient with
 > newcomers on the mailing lists) it seems to be written by someone who
 > really wants you to understand how to use it.  

Security-oriented people seem to be that way a lot.  I think it's the
social responsiblity coming out in different ways.