Anwendungsfall: NSD-Dokumentation ohne Pseudocode (Puristischer Ansatz)

Puristische Algorithmen-Dokumentierer lehnen in Nassi-Shneiderman-Diagrammen geschriebenen Code häufig ab – und das aus gutem Grund. Sie bevorzugen Pseudocode oder sogar natürlichsprachliche verbale Beschreibungen der auszuführenden Schritte. In jedem Fall soll die Darstellung sprachunabhängig sein, womit gemeint ist, dass keine konkrete Programmiersprache angesprochen werden soll.

Andererseits hängen verbale Beschreibungen natürlich von einer bestimmten natürlichen Sprache ab und sind in der Regel mehrdeutig.

Dabei sollte man bedenken, dass Algorithmen nicht auf mathematische oder rechnerische Zwecke beschränkt sind. Man könnte auch einen Algorithmus für den Hausbau, das Steuern eines Autos, die Organisation einer Hochzeitsfeier oder Ähnliches darstellen. Fließkommazahlen oder trigonometrische Funktionen haben dort keinen Platz.

Ein mögliches puristisches (eher abstraktes) Diagramm für unsere (klar berechenbare) Beispielaufgabe, auf Englisch formuliert, könnte folgendermaßen aussehen:

Dieser Ansatz ist intuitiv verständlich, obwohl nicht ersichtlich ist, wie genau das Auftreten doppelter Leerzeichen erkannt und wie die Ersetzung vorgenommen werden soll.

Der Purist könnte die Struktur zwar in eine bestimmte Programmiersprache exportieren, interessiert sich dabei jedoch ausschließlich für die Übersetzung der Strukturen und möchte die Elementtexte erhalten – entweder indem die Anweisungsbeschreibungen in Kommentare umgewandelt werden oder zumindest indem jegliche automatische Transformation der Anweisungssyntax unterbleibt (da es sich nicht um ausführbaren Code handelt). Der resultierende Pascal-Export mit den unten empfohlenen Exporteinstellungen würde beispielsweise so aussehen:

Wichtigste Aktivitäten:

• Element-Einfügung und Diagrammbearbeitung
• Speichern / Laden
• Bildexport
• Codeexport (eher rudimentär)

Empfohlene Einstellungen:

• „View › Analyse structogram?" (Strukturgramm analysieren?): Aus
• „View › Highlight variables?" (Variablen hervorheben?): Aus
• „Preferences › Export ... › Export instructions as comments" (Anweisungen als Kommentare exportieren): Ein
• „Preferences › Export ... › No conversion of the expression/instruction contents" (Keine Konvertierung der Ausdrucks-/Anweisungsinhalte): Ein