Hi,

mir fällt gerade im Wiki auf, dass ich die Verteilung der Beschreibung bzgl. CSS-Eigenschaften auf Doku:CSS/Eigenschaften und Referenzen:CSS/Eigenschaftenreferenz nicht sonderlich sinnvoll finde - die bewirkt doch eigentlich nur doppelten Pflegeaufwand?

Bei HTML bspw. halte ich diese Trennung für sinnvoll - HTML-Elemente können ja bspw. einiges an Attributen haben, auf die alle kaum sinnvoll in der Dokumentation zu HTML eingegangen werden kann;
ausserdem schreibt Christian Seiler ja auch, dass die Referenzen zu HTML automatisch aus den DTDs erstellt werden sollen.
Bei CSS ist eine automatische Erstellung einer Referenz m.W. jedoch nicht möglich, so dass das parallele Vorhalten einer Referenz und einer Doku doppelten Aufwand bedeutet.

Ausserdem sehe ich hier in einer zusätzlichen Referenz keinen Mehrwert - die Beschreibung der möglichen Werte einer Eigenschaft und ggf. spezieller Syntax lässt sich gut in der Doku mit unterbringen.
Klar, eine Referenz sollte kurz und knapp sein, und keinen unnötigen Ballast aufweisen - aber ich denke, da hält die Nennung möglicher Eigenschafts-Werte und Beschreibung im Doku-Teil eine gute Balance ein.
Und auch die Gliederung in der Doku unterscheidet sich nicht groß von der in der aktuellen Fassung der Referenz, so dass schnellere Auffindbarkeit in einer Referenz m.E. auch kein Argument ist in diesem Fall.

Deshalb meine Frage:
Wollen wir das so beibehalten, dass wir bzgl. CSS eine Dokumentation *und* eine Referenz parallel vorhalten, die sich letztendlich vom Nährwert her doch nicht groß unterscheiden;
oder seid ihr eher dafür, beides zusammenzulegen (und unter Referenzen:CSS/Eigenschaftenreferenz dann auf Doku:CSS/Eigenschaften zu verweisen)?

Mir erscheint letzteres sinnvoller.

MfG ChrisB