BeBook and Be Newsletters Available Online

News posted by koki on Sat, 2008-03-22 03:53

It's been almost one year since we announced our conversations with ACCESS Co. Ltd. targeted at releasing legacy BeOS related documents, and today we are happy to inform the community that this project has finally arrived to a happy conclusion: the BeBook and all the Be Newsletters are now available online. As an emerging open source project, documentation for Haiku is still hard to come by; and while our Documentation Team works on creating Haiku-specific material, the BeBook and the Be Newsletters will provide valuable reference material for all developers, new and experienced alike. We want to express our gratitude to ACCESS Co., Ltd. for supporting our project, particularly to Director of Open Source Technologies David "Lefty" Schlesinger, for personally following up on our request. Special thanks also go to community member Simon Kennedy, for nicely formatting the documents for us.

Comments

Re: BeBook and Be Newsletters Available Online

That´s a great step. I was taking a look at the newsletters and remembered the good old times.

It´s fine, now get us the source code :D

Sweet

This is actually extremely great. The original BeOS documentation was 1st class, and the newsletters also explained the 'why', not only the 'how'. This is an enormous asset to the Haiku community. It gives us a starting point to continue improving the documentation. All the Haiku newcomers who would like to start programming for Haiku, now have an excellent reference document which is unparalleled in the open source world.

Re: BeBook and Be Newsletters Available Online

Big thanks ACCESS Co., Ltd.

I like and love this to have this :-)
And it is a good motivation for the Developer he bring haiku to releas.

stargater

Re: BeBook and Be Newsletters Available Online

This is indeed a great news.

Maximizing the BeBook potential

In my use of the BeBook I've encountered numerous bad links. If the BeBook was stored in the source repository (and copied regularly to the website) it would be easier for developers to make these simple corrections.

- Everyone having downloaded the Haiku source would also have a copy of the BeBook.
-- normal edit/commit procedure
-- using one's local copy lessens the strain on the website
-- non-BeOS newcomers would benefit from having their own copy
- Including the BeBook in a Haiku distro, if desired, would be a snap.
- The added benefit of revision control.
- More readily available(?)

Re: BeBook and Be Newsletters Available Online

Can we index all this data with the rest of the site? Being able to actually search the newsletters and the Be Book would be great.

Re: BeBook and Be Newsletters Available Online

Hey BGA ;-) good idear, i like it too , to have the newlatter in the Index form BeBook.

And i have 2 more idears/improvents:
1.) can we add a Haiku like icons for navigate the BeBook, its look more Firefox what we have in time.

2.) can we make the BeBook donwload abel (bebook.zip)

Thanks

stargater

Re: Maximizing the BeBook potential

jonas.kirilla wrote:

In my use of the BeBook I've encountered numerous bad links. If the BeBook was stored in the source repository (and copied regularly to the website) it would be easier for developers to make these simple corrections.

- Everyone having downloaded the Haiku source would also have a copy of the BeBook.
-- normal edit/commit procedure
-- using one's local copy lessens the strain on the website
-- non-BeOS newcomers would benefit from having their own copy
- Including the BeBook in a Haiku distro, if desired, would be a snap.
- The added benefit of revision control.
- More readily available(?)

Using revision control is not an option, as the license does not allow for any changes that would result in derivatives. In other words, both the BeBook and the Be Newsletters are only released as legacy reference documentation "as is". We could put a package online so that people can included the docs in their Haiku builds though.

Re: BeBook and Be Newsletters Available Online

bga wrote:

Can we index all this data with the rest of the site? Being able to actually search the newsletters and the Be Book would be great.

I think we should be able to add Google search capabilities. I will check with Simon.

Searching and indexing

BeHappy was an application which indexed the entire BeBook, allowing instant searching and breakdown based on kit/inheritance/function. A must for every developer.

Re: Searching and indexing

Zenja wrote:

BeHappy was an application which indexed the entire BeBook, allowing instant searching and breakdown based on kit/inheritance/function. A must for every developer.

Now, that's an interesting proposition. The sources are available and are under a MIT license, so it should be possible to modify them as/if needed.