[haiku-doc] Some thoughts about the UserGuide

Hello everybody! This is my first post on this mailing-list, and I'd like to 
thank you all for this great document called UserGuide :) I recently talked 
(very shortly) with Humdinger about this guide. I've been building and testing 
Haiku for a little while now, but haven't really got into it (Haiku) because 
I'm new to the BeOS way of things, until I found out about the GUIDE. Now that 
I've found the userguide is included with builds, I decided I'd post some 
comments/thoughts about it. I haven't finished the Guide yet (I'm up to the 
Workshop, which seems really nice) but some obvious things came up to me. By 
the way, WOW, Haiku/BeOS is certainly an OS worth checking out, I'm very 
impressed at what I learned (and now can do) reading this Guide (coming from a 
Windows, Linux, Mac OS X background).

So, here are my little thoughts:

1.    Haiku UserGuide should be available on documentation page, right now :) . 
I personally think it should gradually replace the need for the sections of 
End-User. All the available sections (Audio & Video, Hardware, Installation 
etc...) should gradually be replaced by chapters from the UserGuide, so what's 
the need anyway? If a document fits into a category, then why shouldn't it be 
in the UserGuide. Which brings me to my second thought...

2.    The UserGuide should include revised versions of the current installation 
documents (and any document relative to a End User). The 3 present on the doc 
page, and some from the development documents (Building from OS X (revised), 
Building from Ubuntu, Installing Haiku to a partition from linux, and any 
others that could help installation while in the pre-alpha throughout to R1). 
Obviously, when Haiku hits R1, the UserGuide should contain basic info on the 
current installation methods. But building from linux and OS X could be put in 
the file, as a bonus. Any info not directly related to developers 
(programming/C++ intense) should be included in the UserGuide. Some articles on 
blogs could be in there too (revised).

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 have posted a thread about this on the forum, and other than the everlasting 
(it seems in the Haiku community) fight about forum vs. mailing list, some 
people pointed me to the web mailing-list, and the enhancement tickets. I 
thought I'd post here first, as I'm quite sure my points were discussed before.

Cheers and congrats,
Socapex_2K



      __________________________________________________________________
Instant Messaging, free SMS, sharing photos and more... Try the new Yahoo! 
Canada Messenger at http://ca.beta.messenger.yahoo.com/

Other related posts: