Die Antwort ist eigentlich gar nicht so schwierig! und wird einem spätestens dann klar, wenn man seine erste Extension erstellt:
Kasper hat das so organisiert, dass man nicht nur Extension Keys für die "eigentlichen Extensions" registriert, sondern auch um eine eigenständige Dokumentation zu schreiben.
Ich habe letztlich eine Dokumentation zum Thema "Typo3 auf Linux Mandrake 9.1" geschrieben und diese als Extension in das Extension Repository hochgeladen.
In der Extension besteht dann eigentlich nur ein File, nämlich im Unterverzeichnis "doc" ein "manual.sxw" File.
Dieses SXW File ist ein OpenOffice Dokument (Open Office ist quasi das Microsoft Word von Linux :-)) im XML Format.
Alle Dokumentationen für Typo3 werden nur noch in diesem Format produziert, da die www.typo3.org Seite diese SXW Dateien automatisch aus dem Extension Repository einlesen kann und die Doku dann unter: http://typo3.org/1421.0.html ( der Dokumentationsseite von Typo3.org) einstellt, ohne dass noch jemand irgend etwas macht.
Stellst Du eine neue Version Deiner Extension auf www.typo3.org bereit, wird automatisch auch Deine Dokumentation - falls Du eine erstellt hast - wieder erneut eingelesen.
Du kannst - wenn Du eine Extension hochlädst - bestimmen, ob Deine Extension im EM angezeigt werden soll oder nicht. Hierfür gibt es dann ein entsprechendes Menü etc.
Für die SXW Dokumentationsdateien gibt es eine Vorlage: http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=290&cHash=8ca184e2e0
Damit man weiss, wie das alles so funktioniert und was wie warum konfiguriert und eingestellt werden muss, liest man am besten folgende Dokumentation:
http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=291&cHash=26debf4caa
Genial Idee, man muss nur erst einmal herausfinden, was Kasper so alles zaubert!!!
Ich lerne jeden Tag was Neues.
Hoffe, das hat Dir ein bisserl weitergeholfen.
Wenn Du noch Fragen hast, ich weiß jetzt, wie das geht :-)
Alwin