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

Howdy,

Humdinger said on Thu, 05 Mar 2009 08:18:16 +0100
> Bertrand Presles wrote:
> > As I said on the bug #2725, I'm volunteer to help on this matter, 
> > so we 
> > should discuss what can I do and what I need to know to get started
> > .
> 
> I haven't seen anyone replying to your offer. Maybe all were 
> distracted with the recent 
> Drupal update...
> Anyway, I'm all for re-organising the how-tos and have them more 
> easily accessed. I wonder 
> if this could be a part of the website for the online version of the 
> user guide which 
> would also provide a way for doing translations. See 
> http://guide.haikuzone.net/
> > Another possible benefit is that we'll be able to HTML-export the how
> -tos as well and have 
> them ship with Haiku images.
> We'd just have another category "HowTos" besides the "Welcome" and 
> "User Guide" and 
> collect the guides there.
> 
> Unfortunately, the mentioned site isn't yet completely ready. But now 
> that Jorge could 
> recuperate from the exertions at SCaLE, it shouldn't take too long. <
> /me poking Jorge> :)

Yeah, sorry about that; I will try to work on it again next week. :)

While this site started as an experiment, I think it has come to a 
point where it can be considered viable for the purpose at hand: provide 
a place for the User's Guide that can also be used as a tool for people 
to participate in the translation of said guide. Given the capabilities 
that it provides, it can potentially be used for other documentation as 
well, if that is desired.

I want to clarify one thing: while the site is in one of my domains 
right now, I do not intend to keep it there. If the site proves itself 
viable and is accepted by the project/community, then I would want it 
to be moved to a haiku-os.org domain or subdomain.

With regards to the desire to use a wiki instead, it is possible to add 
to this system the ability to use medwiki formatting tags, and still 
enjoy the flexbility of HTML/CSS where needed, together with the added 
functions that Drupal provides. So the wiki thing is a possibility that 
can be addressed.

The idea of having more than just the guide is potentially interesting 
too. Perhaps you can selectively add documents that are useful for end-
users, so that they can be exported to HTML for including in the Haiku 
image. What those documents would be, I don't know, but it definitely 
sounds like something to consider.

On a broader perspetive, the Documents section of the website has become 
too scattered IMO, filled with a lot of unmaintained documents many of 
which are out of date. I think this is due in great part to the 
approach of having individually submitted and owned articles, which 
relies on a single individual, thus becoming prone to resulting in 
abandonment.

Perhaps coming up with reduced number of documents that are more focused 
and collectively maintained could produce better results; in such a 
scenario, the translation system put together for the guide could be 
used too, so that the documents can also become multilingual. Perhaps a 
docs.haiku-os.org may be a good place for all this (user guide and 
other docs).

My two cents. Cheers,

Jorge


--
Fortune Cookie Says:



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

Other related posts: