Reorder sections of the user guide

[pulkomandy]

Some users trying Haiku for the first time and getting a bit confused: ​https://www.cpcwiki.eu/forum/emulators/ace-for-haiku/msg187763/#msg187763

The user guide starts with the bootloader menu and digs directly into the filesystem structure, and goes on with stack and tile and keyboard shortcuts.

This does not seem to be the best approach. Shouldn't we start with the basic things: starting apps from the Deskbar menu and finding files in Tracker? And cover the more advanced topics later on in the guide?

[humdinger]

I started the thread "​Reorder sections of the user guide" at the haiku-doc mailing list to get more input.

[lelldorin]

I dont know why my answer on the Mailing list does not listed, here my answer:

We need to thinking like a user here, we need to look from the point that the system is already installed (installation guide).

So the user is looking for?

• apps
• settings
• how to use the system
• Workshops
• there he can get help
• system specific things like filetype, add-ons, driver... are the Last chapter here.

Regards Christian

[humdinger]

This ticket is about re-ordering the existing chapters of the user guide. An actual overhaul of the whole thing would be another ticket... I wouldn't think it's needed, Haiku's documentation has been praised by reviewers in the past.

The general issue, as with all documentation, is to get people to read it. As the forum post PulkoMandy linked to demonstrates. I believe with the inclusion of the Quick Tour - however mangled it came out of the userguide/welcome online tool - we now provide a nice intro for people to get a quick overlook of Haiku's essentials.