[openbeosnetteam] Re: My personal project web page

Brennan told us:
> Having jumped into
> the OpenBeOS project with both feet, I have found the biggest hurdle 
> to 
> becoming a major contributor is
> getting my brain around the overall structure of the OS design and 
> the 
> corresponding source code tree.

So true!

> To help myself, and by extension, other new programmers on the 
> project, 
> I am going to be documenting and diagramming
> as much as I possibly can as I work on my tasks.  My hope is to have  
> web-based 'architecture to code tree' diagram mapping
> of the core kernel and network available to all at some point.  This 
> system would allow you to quickly and easily see
> what source code files comprise which parts of the architecture, and 
> to 
> understand how each part of the system relates to the other parts 
> with 
> regard to overall structure and source code.  I have several schemes 
> in 
> my head for how to do this.

Where have you been all these years, when we're looking after someone 
wanting to do exactly this!
;-)

More serioulsy, that will be a real great addition to OBOS project, as 
the entry cost/learning curve for new coders keeps going up and can 
freak out some of them 
Plus, what happend if some OBOS gurus leave the project with their 
knowledge locked in their brain... or basement ;-) ?

BTW, in the so-little network documentation I tried to indicate for 
each part where live the corresponding source code.
I hope it can be expanded, though.

> I will be hosting this information on my personal server here at home 
> (a G3 iMac, strangely).  You can visit at the following address: 
> http://www.new-wisdom.com.  Be warned, almost nothing is there yet, 
> just a couple of simple system overview diagrams.  

I gave a looks at them, looks fine.
Tree remarks, however:
- BeOS *and* OBOS architecture should have a "device drivers" box.
- it's commonly accepted that BeOS and OBOS kernels *aren't* 
microkernels but modular kernels.
- Applications can interface directly with kernel, without going thru 
Software Kit(s).  
  (Or do we consider libroot.so a *kit*, guys?) That mean the one part 
of the blue box should connect to the green box too...

- Philippe

--
Fortune Cookie Says:

"Every man has his price.  Mine is $3.95."

Other related posts: