[TYPO3] Documentation nightmare

[Andreas Becker]

Very good point Peter

Just had a look to the Joomla stuff and even IMHO joomla sucks but the docs
style are kind we need. Before people start using TYPO3 they would like to
read at least a good introducation and even this isn't uptodate. If you will
have a look to the asterisk dokumentation you can find another document
which really GUIDEs anybody thru everything.

We need some kind of good "schoolbook" for TYPO3 which is logical structured
like you already mentioned.

To write things in Google Docs really makes much fun! much more then in a
wiki. On the other hand an important part is missing and thats' the GLOBAL
structure of all Documents. You can't repeat them in every Google doc as it
would not make sense.

I really want to come back to my suggestion USE and TRY pipeline. Ok it has
been designed for European prisoners but this should not be a handicap as it
is working perfectly and you really can publish complete docs in a TYPO3
style as PDF.
We only need to have fixed A4 Templates (a page should not be longer). Using
"pagewizard" we could create a demo structure for starting Tutorials /
Manuals. Docscould be published in a TYPO3-Bible quaterly AND IMHO charge
for it - why not .

i.e. if this Quaterly complete Book costs 15 Euro it would be much much
cheaper then any other TYPO3 book available at the moment. It would hold
much more then any other TYPO3 Book at the moment. If 1000 People by at
least 1 Quaterly a Year you have 15.000 EURO. For updates of smaller
sections (i.e. an extension) charge 1 Euro - why not. If 500 people update
there 10 major Extensions a year you will have another 5000 Euro which would
make 20.000 Euro a year. I guess this is a whole lot of money to finance a
Team which reviews and REALLY Edits those docs in to a logical and wonderful
example of a Software documentation which could even be awarded. _ Yes why
not call out an award for the best documentation. Try to motivate people to
write good documents.

Have a look to the documents from webempoweredchurch. They all follow the
same structure. They all have a lot of links to videos and other Tutorials.
They are REALLY good. Why? I guess because people write them whose only job
it is to write them :-) and the get paid by an organisation. As said before.
if we continue like it is right now we will throw money out of the TYPO3
window to publishers and printers. So why don't keep it really a TYPO3
thing.

Create all Docs INSIDE Typo3 using pipeline Extension. Try to receive some
supporting money from the EU who runs the pipeline project. as if all TYPO3
stuff would be produced using pipeline, also pipeline would get a BIG push
ahead in the project as I am pretty shure that pipeline would be
perfectionated and both we the DOCusers and the "Prison"Editors would profit
from this idea a lot!

Simply set an Example and USE TYPO3 with all its potential.
Infos are here:
www.pipeline-project.org
Ask Dennis Kranich he is very helpfull
http://typo3.org/extensions/repository/view/pipeline_pdf/

Here we can use the complete already existing potential of TYPO3 :-)

Andi


2008/3/15, Peter Kindström <peter.kindstrom at abc.se>:
>
>
> Why not something like Joomla:
>
>   * The Official Installation Manual for Typo3
>   * The Official User Manual for Typo3
>   * The Official Administrator Manual for Typo3
>   * The Official Developer Manual for Typo3
>
> ...for a start?
>
> And when they are finished, we could start adding more
> specialised documents as "subdocuments" or appendixes?
>
>
>
> /Peter Kindström
>
> _______________________________________________
> TYPO3-english mailing list
> TYPO3-english at lists.netfielders.de
> http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-english
>