[TYPO3-german] Typo3.org: Dokumentation nur auf Englisch

Andreas Becker ab.becker at web.de
Sat May 9 04:18:38 CEST 2009


Hi
Bei all Eurer Diskussion ueber Dokumentation haltet Euch bitte immer auch
vor Augen dass ihr damit verschiedene User bedient.

Developer - Hardcore Progis und andere die sich im Code wohlfuehlen! - die
sind mit dem DOCbook Format sicher ganz happy - Ein WIKI ist denen zu
umstaendlich, zumal da auch jeder andere mitschreiben und womoeglich Sachen
nicht klarstellen, sondern verwirren kann!

Editoren - die TYPO3 wirklich benutzen und sich NICHT intensiv mit dem CODE
auseinandersetzen wollen - die wollen/koennen mit dem was da im DOCbook
Format steht nichts anfangen und wollen lieber ne gute uebersichtliche und
anschauliche Anleitung - die gibt es am Besten in der Form wie bisher. Auch
mit einem Wiki sind die schlichtweg ueberfordert.

Newbees sind wohl von jedem etwas - jedoch gilt auch hier, das eine gute
Anleitung Step by Step der beste Weg ist - siehe die WEC HowTos auf die
inzwischen immer mehr andere nicht WEC Developer in ihren Dokus verweisen.

Auch solltet ihr alles auch einmal aus einer anderen Warte betrachten. Denn
es gibt in TYPO3 Dinge, die sich laufend wiederholen und nicht jedesmal in
einer DOKU breitgetreten werden muessen. Ein Verweis auf eine gute Doku zu
diesem bestimmten Schritt wuerde hier reichen. z.B. wie es einige jetzt mach
- sie verweisen bei "Installation der Extension" auf die Seiten der WEC und
deren Tutorial mit Video. usw.

Ein Wiki ist ein nettes Nachschlagewerk in dem man immer weiter eintauchen
kann, jedoch verzettelt man sich hier viel zu leicht, anstatt sich auf etwas
wesentliches und in sich abgeschlossenens zu konzentrieren.

Noch einmal die Bitte - diskutiert das doch auf der Englischen Liste, denn
dort finden sich auch diejenigen, die es hauptsaechlich betrifft und die von
der mehrsprachigen Doku profitieren wuerden.

Andi


More information about the TYPO3-german mailing list