Kommentare zu: Stylesheets kommentieren mit CSSDOC

Von: F-LOG-GE » Blog Archive » Ressourcen zu CSSDOC

F-LOG-GE » Blog Archive » Ressourcen zu CSSDOC — Fri, 27 Feb 2009 21:11:16 +0000

[...] Vorbild war vor allem JavaDoc. Dirk, der es auch in seinem YAML einsetzt, schrieb darüber im Webkrauts-Adventskalender von 2007 einen einleitenden [...]

Von: Realsatire: Relaunch einer Webagentur | trilodge computin blog

Realsatire: Relaunch einer Webagentur | trilodge computin blog — Fri, 26 Sep 2008 15:02:41 +0000

[...] sie dort hin wo sie hingehören – in eine sauber strukturierte CSS-Datei, vielleicht sogar mit CSS-Doc kommentiert. Selbiges gilt für die inline-Javascripte die auch in eigene Dateien ausgelagert [...]

Von: Ralph

Ralph — Mon, 14 Apr 2008 19:24:36 +0000

Ich habe zwar auch meine eigene Struktur für meine CSS – Dateien, aber ich werde mir dieses Projekt in Ruhe mal genauer anschauen. Danke für diesen Hinweis.

Ralph

Von: Rob

Rob — Sun, 16 Dec 2007 11:21:07 +0000

Interessanter Beitrag. Obwohl es ja noch ein sehr junges Projekt scheint, werde ich das in meinem nächsten Projekt verwenden.

Gruss
Rob

Von: Matthias

Matthias — Fri, 07 Dec 2007 02:59:13 +0000

@Dirk

Ohne Frage steckt da viel Arbeit drin und verdient Anerkennung.

Von: Dirk

Dirk — Thu, 06 Dec 2007 14:14:50 +0000

@Matthias

Werden diese internen CSS-Metas wirklich immer benötigt?

Informationen darüber, ob ein Bugfix validen Code enthält oder nicht, sollen nicht den obligatorischen Durchlauf eines CSS-Validators ersetzen. Sie sind viel mehr als Achtungszeichen zu sehen, falls das CSS durch Tools wie CSSTidy optimiert werden soll. In diesem Fall sollte der Anwender darauf achten, dass das Optimierungstool den ggf. nicht-validen Hack nicht zerstört. Frank Bültge hat in seinem heutigen Blogpost sogar bereits eine erste Einbindung von CSSDOC in UltraEdit vorgestellt, wechle die verschiedenen Tags einsatzbereit vorhält. Vielen Dank an Frank für das tolle Feedback auf den Advendskalender-Artikel. @Dorothea

Gibt es denn analog zu javadoc auch schon ein Tool mit dem man automatisch eine Dokumentation erstellen kann?

Nein, noch gibt es solche Tools leider nicht. Tom Klingenberg steckt derzeit über beide Ohren in der Ersarbeitung einer ersten vollständigen Spezifikation aller Tags einschließlich deren Handhabung. Eine Vorabversion liegt bereits seit einigen Wochen im Netz und freut sich über jedes Nutzerfeedback. Erst wenn diese "technischen Anwendungsregeln" vorliegen, können Programmierer sich daran machen, die Unterstützung für CSSDOC in ihre Software zu implementieren. @David

Eigentlich erstaunlich, dass sich sowas erst jetzt durchzusetzen beginnt.

Stimmt. Auf der anderen Seite, schau Dir Javascript an. Das gibts schon ewig, hat aber erst durch die zahlreichen aktuellen Bibliotheken neuen Auftrieb gewonnen. Hoffen wir also auf ähnliche Effekte. Beste Grüße Dirk

Von: David

David — Wed, 05 Dec 2007 13:36:01 +0000

Ich verwende CSSDOC schon seit einiger Zeit. Man gewinnt deutlich mehr Überblick und die Motivation zum sinnvollen Kommentieren erscheint mir (auch bei den Kollegen) größer. Durch die Tags wird das Wichtige einfacher auf den Punkt gebracht.

Eigentlich erstaunlich, dass sich sowas erst jetzt durchzusetzen beginnt.

Danke für deinen Einsatz, Dirk!

Von: Frank

Frank — Tue, 04 Dec 2007 11:23:34 +0000

Mir gefällt die Idee sehr gut! Schön wäre es, wenn CSSTidy die Kommentare parst.

Danke für den Beitrag!

Von: Daniel

Daniel — Tue, 04 Dec 2007 00:39:02 +0000

Ich hatte neulich schon im Technikwürze Podcast mal reingehört und werde das nun einfach mal im nächsten Projekt testen.

Von: Dorothea Schäfer

Dorothea Schäfer — Mon, 03 Dec 2007 23:42:31 +0000

Hallo,

eine gute Idee!

Gibt es denn analog zu javadoc auch schon ein Tool mit dem man automatisch eine Dokumentation erstellen kann? Idealerweise mit Einbindung der HTML, PHP etc Dateien und deren Hierarchie.

Ich freue mich schon auf die nächsten Türchen!

— Vielen Dank! —

Grüße Dorothea Schäfer