[haiku-doc] Re: End user documentation
- From: Scott Kemp <eightbitz@xxxxxxxxx>
- To: haiku-doc@xxxxxxxxxxxxx
- Date: Tue, 19 Aug 2008 15:35:25 -0700 (PDT)
Sorry I didn't respond sooner. Sounds good. I'll try to work on the doc more
tonight.
----- Original Message ----
From: Humdinger <humdingerb@xxxxxxxxxxxxxx>
To: haiku-doc@xxxxxxxxxxxxx
Sent: Monday, August 18, 2008 1:03:33 PM
Subject: [haiku-doc] Re: End user documentation
Niels Reedijk wrote:
> I believe that documentation has to be structured, else it
> will be a big collection of thoughts that end up nowhere.
I concur.
> So my suggestion would be that a few interested individuals work
> together for a while, to try out some things, draft up some standards
> and then open up for business for the main public.
Scott, if you'd like to, we can continue working on that attributes & queries
doc in odf
format and step by step work out the style. When we think we're ready we beg
the web team
to convert this into a wiki and have others chime in for fine tuning.
With that we work out a kind of docu styleguide and come up with the chapters
that should
be covered. After that it's simply filling in the blanks... :)
> In this sense I see a bright future of webcasts. Short how-to like
> videos that show you, step by step, how to perform certain tasks. The
> division into steps is a good idea, because associated with the
> webcast comes a short document that sums up all the actions (and
> ideally you could click on one of them to jump to the specific moment
> in the webcast video).
Kind regards,
Humdinger
--
--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=--
Deutsche Haiku News @ http://haiku-gazette.blogspot.com
Other related posts:
