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

On Wed, Mar 4, 2009 at 11:18 PM, Humdinger <humdingerb@xxxxxxxxxxxxxx> wrote:
> Hi Bertrand.
>
> Bertrand Presles wrote:
>>
>> Hello,
>>
>> As mentioned on bug #2725, essential guides/how-to are not easily
>> accessible for new comers. And as suggested by umccullough, we should think
>> about collecting all the existing information and make a "Guides" page
>> listing all the existing guides/how-to.
>>
>> On IRC, the other day, I discussed about that with mmadia, and we talked
>> about the way this could be done. I suggested a knowledge base like page,
>> which can be implemented with a Wiki engine for example.
>> Also, we talked about making IRC support access easier. And we suggested
>> offering a web based IRC client, like mmbits.
>>
>> 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...

More likely - real life (in my particular case).

> 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.

The particular area of guides that I am personally interested in
revamping are the ones that explain how to compile haiku on various
platforms using various options that the individual wishes to compile
it with. I believe this particular type of documentation rather
useless for distributing with Haiku itself.

Frankly, the more I think about it, the less inclined I am to do this
in a format other than a Wiki... I am considering using the Trac wiki
on dev.haiku-os.org for this purpose.

But don't wait for me - at this point my personal life is getting more
complicated every week - no telling when I'll actually start said
project.

> 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> :)
>
> Regards,
> Humdinger
-----------------------------------------------------------------------
haiku-web@xxxxxxxxxxxxx - Haiku Web & Developer Support Discussion List

Other related posts: