ComSubVies Creative Content » Dokumentation http://blog.ocrs.at Wed, 17 Mar 2010 12:23:16 +0000 en hourly 1 http://wordpress.org/?v=3.1.3 Tips zum Schreiben von Dokumentationen http://blog.ocrs.at/2009/11/13/tips-zum-schreiben-von-dokumentationen/ http://blog.ocrs.at/2009/11/13/tips-zum-schreiben-von-dokumentationen/#comments Fri, 13 Nov 2009 16:40:57 +0000 Markus Schabel http://blog.ocrs.at/?p=230 Jacob Kaplan-Moss ist an der Phyton Dokumentation beteiligt und hat eine Serie von 3 Artikeln (Writing good documentation) herausgegeben, in der er zusammenfasst, worauf man achten muss, wenn man eine gute Dokumentation schreiben will. Die Serie besteht aus den 3 Teilen What to write, How to write und you need an editor. Man sollte sich diese Artikel zumindest einmal durchgelesen haben, weil hier durchaus schön zusammengefasst wird, worauf es ankommt – und auch welche Unterschiede es zwischen Online-Dokumentationen und gedrucktem Material gibt.

Und nicht vergessen:

Documentation is like sex, when it’s good it’s really really good and when it’s bad it’s better than nothing at all.

]]> http://blog.ocrs.at/2009/11/13/tips-zum-schreiben-von-dokumentationen/feed/ 1 UML Sequence Diagram Online http://blog.ocrs.at/2009/03/29/uml-sequence-diagram-online/ http://blog.ocrs.at/2009/03/29/uml-sequence-diagram-online/#comments Sun, 29 Mar 2009 20:08:06 +0000 Markus Schabel http://blog.ocrs.at/?p=1006 Ich bin heute zufällig über http://www.websequencediagrams.com/ gestolpert, einer Seite auf der man schnell und einfach Sequenzdiagramme erstellen kann. Finde ich sehr gut gelungen und werde ich in Zukunft für derartige Diagramme verwenden.

]]> http://blog.ocrs.at/2009/03/29/uml-sequence-diagram-online/feed/ 0