Einstiegsdokumentation für Entwickler [Gliederung]

Hallo :)

denke seit längerem über eine Einstiegsdokumentation für OXID Neulinge nach. Meine bisherigen Gedanken möchte ich gerne mit euch teilen:

1.) Verzeichnisstruktur
a.) /application/ -> MVC / Templates
b.) /modules/ -> eigene Erweiterungen
c.) /out/ -> CSS, JavaScript, Bilder
d.) ...

2.) PHP und Smarty Notation
a.) PHP -> ungarische Notation
b.) Smarty -> [{...}]

3.) Templating (Frontend)
a.) CSS (Farbkonzept, Schriftarten)
b.) Template-Dateien (.tpl)
-> Produktlisten + Detailseiten
-> Warenkorb + Checkout-Process
-> Mein Konto (Account)
-> CMS-Seiten (Impressum, ...)

4.) Eigene Entwicklungen (Module)
a.) Admin
-> Eigener Menüpunkt (Sidebar)
-> Eigener Tab
-> Bestehende Tab erweitern (Blocks)
b.) Frontend
-> (Modul-)Überladung Funktionalität
-> Templateanpassung mit eigenen Variablen / Abfragen
c.) Datenbankanpassungen
-> Tabelle erweitern
-> Eigene Tabelle definieren

5.) Datenbankabfragen mit OXID Framework

Die Vorlage für meine Idee ist die Dokumentation vom CSS Framework YAML von Dirk Jesse http://www.yaml.de/docs/index.html. Man könnte aus meiner Sicht ein HTML-Dokument gemeinsam verfassen, welches als Einstiegswerk und Nachschlagewerk dient.

So wären meine erste Überlegungen zur Struktur wie dieses HTML-Dokument aussehen könnte. Jemand Lust und Interesse die Struktur zu ändern, erweitern oder zu diskutieren?
Anschließend könnte man gemeinsam an dem Verfassen der Dokumentation arbeiten.

Viele Grüße
indianer3c