Das Gnome-Dokumentationsteam strukturiert Handbuch und Hilfedateien für die kommende Version der 3.0 der Desktopumgebung gründlich um.
An die Stelle der bisherigen Dokumente, die als lineare Abfolge von Kapiteln in Docbook-XML verfasst sind, sollen kurze, aufgabenorientierte Texte treten. In seinem Blogeintrag nennt der Gnome-Entwickler Paul Cutler das Notizprogramm Tomboy als Beispiel. Hier würden Einträge des neuen Stils etwa “Eine Notiz anlegen” oder “Notizen mit anderen Rechnern synchronisieren” heißen.
Neben dem Schreibstil wird auch ein neues Format für Hilfedateien und User Guide zum Einsatz kommen. Es heißt Mallard und stammt von Shaun McCance, dem Leiter von Gnomes Dokumentationsprojekt. Die Auszeichnungssprache basiert ebenfalls auf XML und eignet sich für das Schreiben kurzer, themenspezifischer Texte. Daneben soll sie sich leicht erlernen lassen.
Das Team hat einige Arbeit vor sich: Zum einen ist der Gnome User Guide umfangreich, zum anderen befinden sich neue Desktop-Elemente wie beispielsweise die Gnome Shell derzeit in Entwicklung. Sie müssen sich erst stabilisieren, bevor man die passenden Hilfetexte schreiben kann. Zu den Anwendungen, die neue Hilfedateien erhalten, gehören neben Tomboy auch Banshee, Brasero, F-Spot und Rhythmbox. Tatkräftige Unterstützung ist selbstverständlich erwünscht, auch von Anwendungsentwicklern, die die Dokumente gegenlesen und integrieren sollen.
