[haiku-web] Re: Making guides and essential information easily accessible

Hi,

I would like to offer my opinion, some suggestions and some help in
regards to this thread. I'm going to reply to you all in one message
instead of separated.

First of all, in response to the User Guide, I'm all for putting that
online and using a tool (Drupal) to collaborate and translate. Urias,
I understand your emotions for having a 'pure' wiki, but as Jorge
expressed, most of the wiki-like properties are available in Drupal.
From the maintainer point of view, I would like to add that using
Drupal will prevent us from having to learn and maintain a new Wiki
tool. Instead we can keep the focus of our energies on the tools we
know.

As for Jorge's point, if Humdinger thinks it is a viable way to
maintain the user guide, then I'd say we move the tool inside our
domain as soon as possible. This will allow the integration with our
haiku-os user database. We can install it on the webfaction servers.

On the point of what to do with documentation other than the user
guide, I'm against moving them to the new Drupal/wiki installation. I
think that server should be user documentation only. We might add some
end user tutorials there (how do I set up my gmail mail box?), but
that's enough. We can then drop the category 'End User Documentation'
on our main website.

I also don't think that dev.haiku-os.org is the place for any
documentation. In my view it's the gathering point for information on
the process of developing haiku. It is not the place where you learn
how to compile haiku. So I don't think that's the way to go.

What I would suggest is keeping www.haiku-os.org the main starting and
gathering point for people who want to develop (for) Haiku. In order
to improve the flow of information, I would suggest changing the
documentation section to act like a wiki (much like we want the
userguide website to be). We can then add a block with a menu to all
the different documents (much like the drupal website, see
http://drupal.org/node/23743). We as website maintainers will make
sure that the menu stays updated and logical and users can work on and
correct documents.

Anyway, that's my take.

Niels
-----------------------------------------------------------------------
haiku-web@xxxxxxxxxxxxx - Haiku Web & Developer Support Discussion List

Other related posts: