Saarbrücker Standard 1999

Saar­brück­er Stan­dard 1999 für Soft­ware­doku­men­ta­tion verabschiedet

Der Deutsche EDV-Gericht­stag befaßt sich seit eini­gen Jahren in einem Arbeit­skreis[1] mit dem The­ma Hand­buch und Doku­men­ta­tion. Nach­dem 1998 eine Prüfliste[2] mit Anforderun­gen an die Richtigkeit und Voll­ständigkeit[3]ver­ab­schiedet wor­den war [4], erörterte der EDV-Gericht­stag 1999 gestal­ter­ische Anforderun­gen an die Über­sichtlichkeit und Ver­ständlichkeit der Doku­men­ta­tion für die jew­eili­gen Benutzer. [5]

1. Rechtliche Grundlagen

Die Recht­sprechung des Bun­des­gericht­shofs sieht weit­er­hin die Liefer­ung eines regelmäßig in deutsch­er Sprache abz­u­fassenden Hand­buchs als Hauptleis­tungs-pflicht des Soft­ware­liefer­an­ten an, deren Nichtein­hal­tung den Ver­trag ins­ge­samt scheit­ern läßt.[6]

Aber auch wenn man mit zunehmender Ver­bre­itung der Com­put­er­nutzung statt der Nichter­fül­lung bei Fehlen der Doku­men­ta­tion in Zukun­ft Gewährleis­tungsrecht anwen­den wollte, stellt das Fehlen ein­er Doku­men­ta­tion einen Man­gel dar. Nach dem derzeit­i­gen Stand der Tech­nik und der Mark­tüblichkeit bedarf Soft­ware näm­lich nach wie vor ein­er Doku­men­ta­tion. Dies gilt für alle Arten von Soft­wareme­di­en; lediglich der Aus­führungs­grad kann unter­schiedlich sein.

Min­destanforderun­gen an eine Benutzer­doku­men­ta­tion sind eine Instal­la­tion­san­leitung, eine Über­sicht über den Auf­bau des Pro­gramms sowie die Darstel­lung des Pro­gram­me­in­stiegs und der Behand­lung von Fehlern. Bezüglich derForm der Doku­men­ta­tion die Recht­sprechung zunehmend nicht nur die gedruck­te Form, son­dern auch die für jed­er­mann aus­druck­bare geson­derte Datei zu. Der Her­steller trägt hier­bei die Beweis­last für die Aus­druck­barkeit der notwendi­gen Angaben.

Die Doku­men­ta­tion ist jew­eils dann anzu­passen, wenn Änderun­gen bei der Anwen­dung der Soft­ware erforder­lich sind, die für einen durch­schnit­tl­lich befähigten Nutzer der Ziel­gruppe nicht unmit­tel­bar aus der Soft­ware her­aus ver­ständlich sind. Bei Pro­gram­men, die ständig weit­er­en­twick­elt wer­den, genügt eine etwa jährliche Aktualisierung.

1. Gestal­tung der Dokumentation

Die Gestal­tung der Doku­men­ta­tion hat sich an den Bedürfnis­sen und Fähigkeit­en der vom Her­steller ins Auge gefaßtenZiel­gruppe zu ori­en­tieren und muß für diese ver­ständlich sein. Die von der Recht­sprechung für Benutzer­an­leitun­gen im Rah­men der Pro­duk­thaf­tung entwick­el­ten Grund­sätze sind auf Soft­ware­an­leitun­gen entsprechend anzuwen­den.[7]Für die Gestal­tung tech­nis­ch­er Doku­men­ta­tion beste­hen im übri­gen eine Vielzahl tech­nis­ch­er Nor­men, die auch bei Soft­waran­leitun­gen Gel­tung beanspruchen, z.B. für Benutzer­in­for­ma­tio­nen all­ge­mein[8], für die druck­tech­nis­che Gestal­tung[9] und die Darstel­lung tech­nis­ch­er Grafiken [10].

Ziel dieser Regeln ist ein klar­er, für den Leser erkennbar­er Auf­bau der Doku­men­ta­tion, eine ein­heitliche Begriffsver­wen­dung und eine Gliederung in über­schaubare Infor­ma­tion­spakete. Hand­lungsan­weisun­gen müssen auch sprach­lich klar von erk­lären­den Teilen getren­nt sein. Dem heuti­gen Stan­dard entsprechen weit­er sog. Leselin­ien, die einen Schnell­durch­gang durch die Infor­ma­tion für den geübten Nutzer und einge­hen­dere Erläuterun­gen für den uner­fahre­nen vorse­hen. Ver­bote und War­nun­gen müssen klar aus­ge­sprochen und begrün­det wer­den.[11]

Bei der grafis­chen Gestal­tung dür­fen nicht zu viele Details auf ein­mal ange­boten wer­den und ist eine Erläuterung von Mask­endarstel­lun­gen z.B. mit Hil­fe von Pfeilen und Erläuterun­gen erforder­lich, die dem Leser die Bil­daus­sage erschließt. Die Ver­wen­dung gebräuch­lich­er Schrifft­typen und For­matierun­gen und eine ein­wand­freie Zuord­nung von Text- und Bil­daus­sagen sind weit­ere Anforderun­gen an die Ver­ständlichkeit der Dokumentation.

Der fol­gende nach einge­hen­der Diskus­sion als Saar­brück­er Stan­dard ver­ab­schiedete Kri­te­rienkat­a­log faßt die Ergeb­nisse der bish­eri­gen Beschäf­ti­gung mit dem The­ma zusam­men. Er soll den Her­stellern von Soft­ware als Ori­en­tierungs­maßstab dienen und die rechtlichen Anforderun­gen an eine ord­nungs­gemäße Doku­men­ta­tion definieren.

III. Saar­brück­er Stan­dard für Soft­ware- Anwen­der­hand­büch­er 1999

1. Richtigkeit (Dr. Stre­itz)[12]
2. a)Identifizierende Angaben

- Pro­gramm­beze­ich­nung

- Pro­gram­mver­sions-Nr.

- ggfs. Lizenz-Nr., Vertrags-Nr.

- Hand­buch-Ver­sions-Nr.

1. b)Programmkonforme Darstel­lung

- des Programmaufbaus

- der Programmfunktionen

- der Feldbezeichnungen

- der möglichen Feldinhalte

2. Voll­ständigkeit (Dr. Stre­itz)
3. a)Installationsbeschreibung

- Auflis­tung der geliefer­ten Unterlagen

- Sys­temvo­raus­set­zun­gen (Hardware/Software)

- Qual­i­fika­tion des Anwenders

- Sicher­heit­shin­weise

- tech­nis­che Beschrei­bungsmerk­male des Programms

- Instal­la­tion­san­leitung

- Stan­dard und Sonderformen

- Erk­lärung der Installations-Parameter,

- typ­is­che Systemverhaltenskennzahlen

- Opti­mierungsvorschläge

- benutzer­spez­i­fis­che Anpassungen

- Reg­is­tra­tions- und Garantieunterlagen

1. b)Beschreibung der Programm-Funktionalitäten

Auf­gaben­stel­lung und Ein­satzge­bi­et des Programms

- Menüstruk­tur (Funk­tion­s­ablauf)

- Pro­gram­ma­blauf der jew­eili­gen Einzelaufgaben

- zugrun­deliegende Nor­men und Konventionen

- Grund­la­gen und Berechnungsmethoden

- Befehls-Kurz-Über­sicht (Ref­er­ence Card)

- Muster­beispiele für Standardaufgaben

- Tips und Tricks (Expert-Modus)

1. c)Benutzer-Daten

- Struk­tur

- Spe­icherung

1. d)Verhalten in Ausnahmesituationen

- Erläuterung jed­er einzel­nen Fehlermeldung

- Hin­weise auf zu ergreifende Maßnahmen

- Maß­nah­men bei Abwe­ichun­gen zwis­chen erwartetem und

tat­säch­lichem Ergebnis

1. e)Unterstützung durch den Pro­gramm­liefer­an­ten/-her­steller

- Kon­tak­tadresse für den Benutzer

- Hot­line, soweit vorhanden

3. Übersichtlichkeit/Verständlichkeit (Pöt­ter)
4. a)Zielgruppenbezug

- Fachken­nt­nisse

- All­ge­mein­bil­dung

- Erwartungss­chema­ta und Wahrnehmungsfilter

1. b)Aufbau

- pro­duk­to­ri­en­tiert (Rei­hen­folge der Funktionen)

benutze­ror­i­en­tiert (nach typ­is­chem Arbeitsablauf) Maskenfunktionen

- über­sichtliche hier­ar­chis­che Gliederung

- Infor­ma­tion­s­menge je nach men­taler Verarbeitungskapazität

1. c)Orientierungshilfen

- struk­turi­ertes Inhaltsverzeichnis

- alpha­betis­ches Stichworteverzeichnis

- ggf. Glos­sar (Verze­ich­nis der Abkürzun­gen und Fachausdrücke)

1. d)Textverständlichkeit

- jew­eilige Landessprache

- sprach­liche Richtigkeit

1. e)Wortwahl

- ein­heitlich durchgängige Begrifflichkeit

- Ver­mei­dung oder sofor­tige Erk­lärung von Fremdwörtern

- Ver­mei­dung nicht­gängiger Worte und Abkürzungen

- genormte Sig­nal­wörter bei Warnungen

1. f)Satzkonstruktion

- kurze voll­ständi­ge Sätze

- Voranstel­lung der wesentlichen Aussage

- unter­schiedlich­er Sprach­stil für beschreibende

und hand­lung­sori­en­tierte Teile

1. g)Motivationssteuerung

- optis­che Tren­nung von Haupt- und Zusatzinformationen

(Lese­führung)

- Textab­schnitte mit jew­eils voll­ständi­gen Informationen

im Hin­blick auf Quereinsteiger

1. h)Bildgestaltung

- Ver­wen­dung von Standardfarben

- Lokalisierung und Iden­ti­fizierung durch Bildaussagen

- real­is­tis­che Mask­endarstel­lung mit konkreter Blick-

lenkung

- Vor­ma­ch-/Nach­machtech­nik für Handlungsanweisungen

1. i)Typografie und Layout

- Text/Bildzuordnung

- gebräuch­liche Schrift­typen und ‑größen

- erkennbare Schriftgradunterschiede

- opti­male Zeilen­län­gen und ‑abstände

- Buch­for­mat mit Bindung zweckmäßig

Fußnoten:

[1] Lei­t­erin: Rich­terin am Amts­gericht Mar­garethe Bergmann, Köln.

[2] Abge­druckt in CR 1998, 573.

[3] Diese beruht auf Vorschlä­gen der Sachver­ständi­genso­ci­etät Dr. Siegfried Stre­itz in Brühl.

[4] vgl. auch die Erläuterun­gen von Brandt, CR 1998, 571 und Bergmann, CR 1998, 455.

[5] Die Vorschlagsliste für diese Merk­male ist vom Sachver­ständi­gen­büro Gode­hard Pöt­ter in Reck­ling­hausen erstellt worden.

[6] Vgl. die Nach­weise bei Beck­mann,CR 1998, 519.

[7]> Vgl. z.B. BGH NJW 1992, 560 ( Kinder­tee-Urteil )

[8] z.B. DIN V 8418 — Benutzer­in­for­ma­tio­nen; DIN V 766055- Gebrauchsanweisungen

[9] Z.B. DIN 1422- Typografis­che Gestal­tung; DIN 1450- Schriften, Leser­lichkeit; DIN 1451 — Schriften, DIN 16507 Typografis­che Maße

[10] z.B. DIN 4844 — Sicher­heitskennze­ich­nung, DIN 30600 Grafis­che Sym­bole, DIN 32830 Gestal­tungs– regeln für grafis­che Sym­bole in der tech­nis­chen Produktdokumentation

[11] vgl. z.B. VDI 4500, Pkt. 2.4 Satz 12, DIN V 66055, Pkt. 7.2, vgl. dazu auch OLG Düs­sel­dorf NJW– RR 1995, 25

[12] Die Beze­ich­nung in Klam­mern gibt jew­eils das Sachver­ständi­gen­büro wieder, auf dessen Vorschlag die nach­fol­gen­den Kri­te­rien aufgenom­men wurden.