[Typo3-documentation] Previous message #5 (was: Fwd: Re: Help with Installation documentation?)

[Michael Stucki]

Subject: Re: Help with Installation documentation?
Date: Sonntag, 13. Juni 2004 19.46
From: "Peter Kindström" <peter.kindstrom at abc.se>
To: mundaun at gmx.ch, jms at marktauftritte.ch
Cc: ledj-typo3 at dcmedia.biz

Hi all

> Since there seems to be an interest to be working on
> documentations we should try to combine our efforts and work
> together.
>
> Before anyone starts inventing the wheel several times we should make
> sure that nobody wastes time with writing because it already has been
> done.

I agree, and that is just why I posted my email. Before I start
writing, I want to know the goal. In this case I would like to
know what different documents there should be and what their
subject should be.

And my suggestion for TYPO3 is many smaller documents rather
than a few very big ones. And that we devide the documents into
some distinct categories.
I also think that every category should have at least one
"Basic" document for the average user/subject and then one or
more specialised document for specialised things. (See the
structure suggestion in my first email)

> I also want to wait with any major documentation changes until
> the book by the Typo3 comes out to see what needs to be added or
> improved.

Yes, before we _write_ anything. But we can start planning the
structure and what document we would like to have (the goal)! It
looks like now is a very good time to plan and when the book
comes we just can start writing!
I like writing, but I like planning even more!  :-)

> For now I think focussing on a overall installation documentation
> is worth the time being spent.

What do you mean by an _overall_ install doc? One huge document
covering all aspects of installation and upgrading? Or do we
agree on many smaller documents



Regards,
Peter Kindström  <peter.kindstrom at abc.se>