On Freitag 13 Februar 2009 18:19:48 Robert Frießleben wrote:
Aus der Hilfe von Openoffice,org 3 zu: ADRESSE(Funktion): [langen Hilfetext aus dem Zitat entfernt] Also ich kenne wesentlich schlechte Dokumentationen
Eine Programmoberfläche ist nicht hochwertig, wenn es ein besonders detailliertes Handbuch hat, sondern wenn man das Handbuch niemals braucht, weil die Oberfläche selbsterklärend ist. Ich jedenfalls habe (wie vermutlich über 95% aller Anwender) noch nie das OOo-Handbuch benutzt. Ich habe auch noch nie eines der Handbücher von KDE oder openSUSE oder was-weiß-ich benutzt.
Man merkt vielleicht, dass ich dem Grundkonzept des Handbuchs abgeneigt bin. Manpages und Infopages sind aufgrund der Beschränkungen des Ausgabemediums sehr nützlich (ebenso Referenzhandbücher für APIs), aber eine grafische Oberfläche sollte quasi sein eigenes Handbuch sein, indem es den Anwender in den gewünschten Arbeitsabläufen unterstützt und die evtl. doch benötigte Dokumentation sofort verfügbar macht.
Ich muss mal wieder zu OOo zurückzukommen, denn es kommt noch ein zweiter Faktor dazu. Wie ich gerade durch Nachgucken festgestellt habe, steht im Funktion-Hinzufügen-Dialog, nachdem man die Funktion ADRESSE ausgewählt hat, tatsächlich eine Parameterbeschreibung, die explizit die "Zeilennummer" bzw. "Spaltennummer" fordert. Das habe ich heute früh wohl nicht gesehen, weil ich damals aufgrund eines nicht direkt mit OOo zusammenhängenden Programmierproblems ziemlich ... aufgebracht war.
Wenn ich der Entwickler dieses Dialogs wäre, würden jetzt bei mir alle Alarmglocken schrillen. In dem Dialog ist eindeutig zuviel Text. Statt dem großen Bereich mit Funktions- und Parameterbeschreibung sollte es solche Tooltips geben, die diese Beschreibungen enthalten (so wie in den gängigen Entwicklungsumgebungen, beim Klassenfeind heißt sowas "Intellisense").
Als sinnvolle Zusatzlektüre empfehle ich die Ausführungen von Joel Spolsky zu dem Thema des Interface-Designs:
http://www.joelonsoftware.com/uibook/chapters/fog0000000062.html
Gruß Stefan