[openbeosmediakit] Media Kit documentation

I received an en email by Jeff Biss,
who is doing documentation for the OpenBeOS.

But I see a few major problems in this.
* Gobe format isn't very handy, and doesn't have working links
* HTML would be much better for reference during deveopment
* currently, we are not changing any functionality, so
* there aren't any additions yet.
* I don't know the exact meaning of markup, "rise a price" doesn't
* seem to be correct :)
* we have some undocumented areas (sample code only), as driver
* interfaces etc. these one need better documentation, or newsletter 
* articles that need to be added to the documentation. Do we have 
* to do this, or will you be doing it?

regards
Marcus

>Marcus,
>
>My name is Jeff Biss and I am converting the existing BeBook for use 
>with the OpenBeOS project. I'm [...] able to 
>send you the first half that I have completed.
>
>I am sending the files in a WinZip file since I am in NT at the moment 
>and have just finished working in FrameMaker in my regular job. The 
>files are in GoBeProductive format. Regarding the review/update process:
>
>- The files are conversions directly from the BeBook included in Be ver. 5
>- Review only the content for relevance and accuracy. I haven't taken 
>the time to figure out how to include graphics in GoBeProductive yet so 
>they are missing.
>- Do not worry about format. This is a first pass and needs improvement.
>- Mark up as you see fit.
>- I will leave these files on my system as they were sent to you and 
>will use your markups when you send them back.
>- These files will be used to produce a PDF version and HTML so their 
>organization will change to make this process easy and maintainable.
>
>I need to know what people need, such as what file format.
>
>- I have done this in GoBeProductive but that program produces Word 
>format files and ultimately I will use FrameMaker to produce the book. 
> From that book the PDF and HTML will be produced. Since most people do 
>not do desktop publishing most do not have FrameMaker so I need to use a 
>program that everyone can use initially.
[...]
>Sincerely, Jeff Biss
>Documentation for OpenBeOS

I have uploaded it here: http://beos.overhagen.de/1st half of Media kit.zip

Other related posts: