Hi,

Eine Gruppe von drei Leuten hat sich zusammengetan und möchte versuchen Kommentare in CSS-Dateien zu standardisieren.
Das ganze heißt CSSDOC und steckt noch in den Kinderschuhen, erste Entwürfe gibt es jedoch schon:
Schema soll ein aus anderen Sprachen bekanntes sein und lehnt sich an Javadoc an:
Vom Standard festgelegt wird, wo diese Blöcke ("DocBlock") einzusetzen sind und welche Tags für welche Bereiche es gibt.

Meiner Meinung nach ein ganz netter Ansatz, aber für CSS ein bisschen übertrieben.
Zwar ist diese Kommentarform sehr übersichtlich und wohlbekannt, aber es ist schon noch ein großer Unterschied, ob man ein Projekt von 100.000 Zeilen und 100 Dateien oder mehr kommentieren möchte, oder doch einfach nur ein oder zwei CSS-Dateien. Kompaktere Kommentare wären also sinnvoll und ob diese ganzen Tags wirklich gebraucht werden, oder einfach nur von den Entwickler mühsam aus der Nase gezogen wurden ist so leicht auch nicht zu beantworten.
Ein weiterer Kritikpunkt ist, dass Dateien auf Webseiten nach Möglichkeit so gut es geht komprimiert sein sollten. Und zwar nicht nur mit gzip, sondern auch durch entfernen von überflüssigen Kommentaren, zumindest in der öffentlichen Version (privat können und sollen natürlich Kommentare und White-Space gesetzt werden). Der Nutzen für die Öffentlichkeit (bzw. der interessierte Teil der Seiten-Besucher) tendiert also gegen null, der Vorteil für Entwickler kann sich erst in größeren Teams aufbauen. Für einen selbst kann man schließlich besser die eigene Kommentierweise verwenden und so einen noch besseren Überblick behalten.

Dennoch lobenswert, dass sich jemand um die CSS-Dateien kümmern möchte und vielleicht wird es ja in den nächsten Versionen noch massive Veränderungen geben.

[parallel auch auf meinem Blog veröffentlicht]

Gruß,
Pablo

__________________
Go Opera!

Einer der drei Leute ist ja Dirk Jesse (YAML), und für YAML ist das ganze sehr vorteilhaft.

__________________
Applikations-Programmierung:
BlitzMax, BlitzPlus, C#

Webentwicklung:
PHP, HTML, XHTML, CSS, JavaScript, AJAX, MySQL, ASP

Für Webseite die Tutorials anbieten und oder von bekannten Designer, finde ich Kommentare auch sehr sinnvoll.
In der CSS von Molly E. Holzschlag findet man zum Beispiel auch einige Kommentare zu einzelnen vorgehensweisen.

Nur ob ein Kommentarblock als Einleitung für eine CSS Datei sinnvoll ist, ist wiederum eine andere Frage. Ich persönlich wüsste nicht was ich da schreiben sollte, bis auf Author, Ertstellungs- und Change Datum.

Irgendwie unsinnig. Kommentare haben in fertigen Dokumenten nichts zu suchen und als Gedankenstütze während der Entwicklung reicht locker eine Zeile.

__________________
Schützenverein „Einigkeit“ Autenzell-Rettenbach
meisterschuetzen.net - Der Treffpunkt für Sportschützen

Also erstmal finde ich die Idee sehr gut, natürlich lohnt sich das erst bei größeren Projekten, doch ich würde sie in der kurzen Schreibweise trotzdem nutzen.

Das Beispiel wie du es aufgeführt hast kam mir schon in YAML bekannt vor, und da würde ich nicht mehr von einem unsinnigen Projekt sprechen.

Bei zweisprachigen Projekten mit großen CSS-Dateien hilft das ungemein, wie man schön an der Original YAML-Basedatei sehen kann. Ohne diese Kommentare wäre die Einarbeitung in YAML sicher sehr schwer, womit man dann auch noch die Nützlichkeit in einem öffentlichen CMS beweisen könnte.