[haiku-doc] Re: Some thoughts about the UserGuide

Hi!

Philippe Michael Groarke wrote:
1. Haiku UserGuide should be available on documentation page, right now :) . 

I feel so, too. :)
Although, recently the topic of translations came up and we're not yet completely sure how best to deal with that. It may turn out that a kind of wiki approach will be chosen. So, it maybe makes sense to hold off for just a little bit longer and have it all in one fell swoop.
2. The UserGuide should include revised versions of the current installation documents (and any document relative to a End User).
I first thought that the user guide should only hold the official installation procedure that'll be there at least with R1. But, considering that this will probably be quite some time off yet, putting in some hands-on instructions how to get Haiku and run it makes sense. When the official method (e.g. burning an ISO and CD-auto-start after reboot to the Installer) is there, these very technical solution should be removed from the user guide. Or at least moved to an "Advanced" section. We'll see.
If you want to include those documents into the UserGuide, or some of them, I'd be willing to help with formating and corrections.
I recently put together a document ( http://www.haiku-gazette.de/node/200 ) that combined a few blog articles and shows how to get the source and build/install images under Linux. It would fit nicely as advanced-installation topic into the user guide. It's in German though... :)
There is another blog entry on haiku-os.org that deals with all the different virtual machines that can run Haiku. I have no way to check if it's accurate, but if you feel this or another topic should be added we can discuss it here. 
Then, if you want to, you could just grab a user guide HTML and fill in a new 
chapter.

Regards,
Humdinger

--
--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-
Deutsche Haiku News @ http://www.haiku-gazette.de

Other related posts: