In welcher Grammatik soll ich meine Spezifikationen schreiben?

Wir schreiben derzeit funktionale und technische Spezifikationen in einem zweispaltigen Format. Zusammenfassungssatz und technisches Detail. Die Details beziehen sich oft auf einen Anhang mit Diagrammen, Layoutdesigns ect.

Ich kämpfe jedoch mit der Zeit, in der ich es schreiben muss:

In der Vergangenheitsform, als wäre die Arbeit erledigt, bemühe ich mich, die wichtigsten Erweiterungen der aufregenden Arbeit aufzuzeigen. Future Tense wie es sein muss X fängt an wie eine To-Do-Liste zu klingen oder Tense neutral, sehr hart, wie es entweder getan werden muss oder getan wird.

Um weitere Verwirrung zu stiften, kann diese Spezifikation von Personen gelesen werden, die kein Englisch als Muttersprache haben.

Davon haben wir an meinem letzten Arbeitsplatz reichlich.

Die Produktmanager haben beschlossen, die Gegenwart zu verwenden, um zu beschreiben, was getan werden muss , wie:

Der Benutzer sendet eine Bestellung. Das System sendet eine Bestätigungsnachricht.

Leider wurde die Beschreibung der Voraussetzungen auch in der Gegenwart vorgenommen, wie:

Der Benutzer legt einen Artikel in den Warenkorb und gibt die Menge an.

Dies hat für mich viel Verwirrung gestiftet, da nicht klar ist, was bereits ist und was noch kommen wird. Ich habe versucht, sie dazu zu bringen, eine Zukunftsform zu verwenden, aber sie mussten sich nie ändern. Persönlich konnte ich mich in all meinen zwei Jahren dort nicht daran gewöhnen. Es ergibt einfach keinen Sinn, hört sich so an, als ob jemand die Zeitformen der Sprachen nicht beherrscht.

Deshalb:

• Verwenden Sie eine Gegenwartsform für das, was bereits existiert

• Verwenden Sie eine Zeitform für das, was getan werden muss. Beschäftige die Welten "sollte", "muss", "wird".

Gegenwart scheint mir gut zu sein.

1. Voraussetzung: Foo befindet sich im Zustand X
2. Operation: dies und das passieren
3. Nachbedingung: Foo befindet sich im Zustand Y

alle diese sind in der Gegenwart.

Oder wenn es ein "Projektstatus" ist

1. Version 10: verfügt über die Funktionen A, B, C und D

2. Version 10.1: enthält Verbesserungen an A. Behebt den Fehler 1049 in B. Fügt die neue Funktion E hinzu.

Vielleicht möchten Sie wissen, wie Sie RFCs schreiben.

Dies ist RFC 2119: Schlüsselwörter zur Verwendung in RFCs zur Angabe von Anforderungsstufen .

Spezifikationen sind Anweisungen. schreibe sie in der Gegenwart. so was.

Wenn ich Entwürfe für Software erstelle, bevorzuge ich die Gegenwart, auch wenn ich die Entwürfe erst erst erstelle, bevor die Software existiert. Auch nachdem eine Softwareanwendung aus dem Entwurf implementiert wurde, ist der Entwurf immer noch relevant und ein wichtiges Dokument. Es ist durchaus möglich, dass ein Designdokument nach der Implementierung der Software für einen längeren Zeitraum relevant bleibt als vor der Implementierung.