On Sun, 22 Jul 2001, Sean 'Shaleh' Perry wrote:
> On 22-Jul-2001 Chris Bacott wrote:
> > Or should I just read the source? I want to work on BB, but I can't find any
> > docs.
>
> it is all in the source, no other docs. The good news is the code blackbox
> code is well named, designed and layed out. bbtools is a little harder to
> follow but is also fairly easy.
That's true, I had no problem understanding the code. But code is
self-explanatory anyways. The thing I'd like to see in Blackbox is either
development documentation or better comments on the source files. Things
like 'What this class/file is for' is not answered at all in the
sources... At the start of the files there's just copyright etc.
statements. To actually know what the class is for, you must read the
source files for the class.
Also, documenting complex processes like the reconfiguration (which leaks
memory btw.) would help others to look into the code. With documentation
there would no be no need to do so much detective work to figure out what
the process does. Answering such fundamental questions like WHY can not
even be done by reading the code.
