Orchid XP v8 wrote:
> It always surprises me when a big well-known "jewl" of the open source 
> scene has really poor documentation. You'd think something that popular 
> would be well-documented...

Yeah. Stuff like Freenet, which last I looked, was documented by people 
reading the source code and trying to figure out what it did well enough 
to write a user manual on how to use it. Like, WTF?

I personally can't imagine how you even start a major complicated 
project without writing some documentation first. "Hey, let's make this 
database engine, write all the code, then try to figure out what the 
layout in the files will be and what the API to access it should look 
like."  WTF?  At a minimum, put the notes you made while you were 
thinking about it on the wiki along with everything else.

-- 
Darren New / San Diego, CA, USA (PST)
  Helpful housekeeping hints:
   Check your feather pillows for holes
    before putting them in the washing machine.

Post a reply to this message