[TYPO3] Documentation nightmare

Daniel Bruessler danielb at typo3.org
Sat Mar 15 20:53:12 CET 2008


Hello Andreas,

that's a very big one ;-) Thank you!

Needs some time to read&think about it. I just marked it in orange, yet.

Cheers!
Daniel


> Hi Dan
> 
> Discussion and Versioning and especially collaborating in differnt ways is
> also possible with the mentioned solutions above + it is much easier to put
> the complete manual/tutorial afterwards always in its newest Version into
> the extensions.
> 
> Everyone who develops extensions and HAS to write therfore manuals needs
> open openoffice to create the manuals and actually those are also the people
> we are looking for to write the manuals. In other words OpenOffice is
> already some kind of standard for the TYPO3 documentation ;-)
> 
> The problem with links inside documents is absolutly right but this will
> happen the same way in OO as in a Wiki as people don't take care for the
> pages the link points to. i.e. have a look to wikipedia and see how many
> links are simply pointing simply to empty pages ;-) Ok they have a reminder
> "you could be the first one starting this article".
> 
> 100% of Extension documentation is been created in OO Format as the
> extensions and TYPO3 are reading only OO - i.e. the backend extension
> viewer. So why should we do things twice or loose things thru conversions
> and so on. Also on the mentioned OOOnline Pages you can alsways collaborate
> with only a certain number of people (Professionals - extension developer
> itself, co-author for the tutorial and some kind of Chef Editor who checks
> the general Layout like mentioned from Peter (Strukture ...)
> 
> There would be also another REAL TYPO3 solution which would enable people to
> collaborate and even upload word or oo formats. Try out the extension
> pipeline and create a REAL TYPO3 Online Book with it. It is a great project
> and already in use and supported by EU afaik. This would be a real TYPO3
> solution.
> 
> The CHEF Editor (i.e. Peter) would setup the strukture and for each new
> extension another subsection. This would automatically be added into the
> index (sitemap) The Pages in pipeline are fixed to A4 size which makes it
> very easy to have a wysiwig look in TYPO3 and the same afterwards in your
> PDF. Another Plus would be to printout sections as PDF and "sell" them the
> same sell a BIG complete "PDF" with everything in there.
> 
> Translations could be managed in a TYPO3 style and printed out separatly. We
> could even connect those created content to LIVING Content like
> Audio/Video/Flash - Opening up in Lightboxes using one of Georgs extensions.
> 
> Why using other software when TYPO3 has already such great extensions like
> pipeline to create whole books in a collaborative style online. This would
> be REAL TYPO3 ;-)
> 
> Andi


More information about the TYPO3-english mailing list