Wie strukturieren und verfassen Sie Ihre technischen Spezifikationen?
Im Rahmen eines digitalen Projekts und der Erstellung des Lastenhefts sind die technischen Spezifikationen die Übersetzung der funktionalen Spektren in Mittel und Lösungen.
Welche Technologien, welche Hardware und welche Architektur werden Sie einsetzen, damit die Funktionen Ihres Webprodukts optimal funktionieren und die Bedürfnisse der Nutzer erfüllen?
Entdecken Sie Beispiele, Tools und Tipps, um dieses für die Einordnung Ihres Webprojekts notwendige Dokument zu verfassen:
Was ist eine technische Spezifikation?
Definition der technischen Spezifikation
Hierbei handelt es sich um die Dokumentation der Methoden, Verfahren und Technologien, die ausgewählt wurden, um die Einschränkungen bei der Durchführung des Projekts zu bewältigen.
Openclassroom
Eine Spezifikation definiert einen expliziten Satz von Anforderungen, die von einem Produkt oder einer Dienstleistung erfüllt werden müssen.
Im Web-Projektmanagement, sei es Software, eine Website oder eine Anwendung, befasst sich die funktionale Spezifikation mit der Funktionalität, die entwickelt wird, um das Nutzererlebnis zu verbessern.entwickelt, um die Erfahrung eines Nutzers zu befriedigen, während sich die technische Spezifikation auf die Mittel zur Umsetzung dieser Funktionalität bezieht, wie z. B. :
- Technologien ;
die Architektur ;
die Hardware.
Sie verfassen das Lastenheft für Ihr digitales Projekt auf der Grundlage des Bedarfsausdrucks.
Deshalb spricht man auch von der technischen Bedarfsspezifikation (STB), da das Dokument den Bedarf eines Kunden in technische Anforderungen und Einschränkungen übersetzt.
🤓 Beispiel einer Spezifikation für eine Website :
- die funktionale Anforderung: eine schnelle Ladezeit ;
- STB: Die Seite muss die HTML-Standards verwenden und Bilder mit einer Größe von weniger als 200 KB enthalten.
Was sind ihre Ziele?
Die technischen und funktionalen Spezifikationen werden im Anschluss an die Konzeption des Webprojekts und im Vorfeld seiner Umsetzung verfasst. Dies ist die Startphase des Projekts.
Sie geben detailliert an , wie das Produkt entwickelt werden muss, um die Bedürfnisse der Nutzer zu erfüllen, welche Komponenten und Werkzeuge benötigt werden.
Die Specs sollen aber auch einen klaren Start ermöglichen und alle Beteiligten, insbesondere den Kunden, das Projektteam und das technische Team, über die entwickelten Dienste und die verwendeten Lösungen einig werden lassen.
Beispiel für eine technische Spezifikation
Entdecken Sie hier ein Beispiel für ein Lastenheft mit technischen Spezifikationen, das von Openclassrooms für ein Online-Kommunikationsprojekt vorgeschlagen wurde.
Wer verfasst die technischen Spezifikationen?
Das technische Team ist am besten in der Lage, dieses Dokument zu verfassen, d. h. :
- die oder der CTO ;
- die Entwicklerinnen und Entwickler.
Der Product Owner oder Projekt-/Produktmanager sorgt für die richtige Formatierung des Dokuments.
Was ist der Inhalt der technischen Spezifikationen?
Die technischen Spezifikationen können Folgendes enthalten:
- die technologischen Entscheidungen;
- die Domains und das Hosting ;
- die Umgebung/Architektur(Betriebssystem, Webserver und Anwendungsserver) ;
- Anforderungen an die Programmierung (Computersprache) ;
- Zugänglichkeit (Kompatibilität von Browsern, Software, Geräten) ;
- Sicherheit;
- Wartung und Weiterentwicklung ;
- die vorläufige Planung;
- das Glossar der technischen Begriffe.
Wie verfasst man eine technische Spezifikation?
Sie haben den funktionalen Umfang des Webprojekts festgelegt und die funktionalen Spezifikationen, die Übersetzung der Anforderungen in Funktionalitäten, verfasst?
Dann ist es jetzt an der Zeit, den technischen Teil der Spezifikation zu verfassen und zu beschreiben, wie diese Funktionen umgesetzt werden sollen.
Schritt 1 - Wählen Sie ein Format.
Es ist möglich, ein offenes oder geschlossenes Format zu wählen.
Im 1ᵉʳ-Fall konzentrieren sich die technischen Spezifikationen auf die Leistung der Funktionen, gehen aber nicht näher auf die technischen Mittel ein, um diese zu erreichen, die im Ermessen des Entwicklerteams liegen.
Das geschlossene Format hingegen präzisiert :
- die Werkzeuge ;
- das Verfahren ;
- den Produktionsablauf der Teilfunktionen.
Wenn Sie die monday.com-Software für Ihr Projektmanagement verwenden, haben Sie Zugang zu anpassbaren Vorlagen für Produktspezifikationsblätter, um Ihre Erwartungen schnell und einfach zu formulieren.
Schritt 2 - Strukturieren Sie Ihre Überlegungen.
Ein grafisches Hilfsmittel wie eine Tabelle oder ein Diagramm kann Ihnen helfen, Ihre Specs vor dem Verfassen zu strukturieren, wie z. B. das FAST-Diagramm, das von der Erfassung aller Dienstleistungsfunktionen bis hin zu den Funktionen und technischen Lösungen reicht.
Schritt 3 - Bewerten Sie die technischen Entscheidungen.
Sind sie alle notwendig und relevant?
Wenn sich das Team über technische Entscheidungen nicht einig ist, gibt es die Methode der Scorecard (Bewertungsbogen), um diese zu bewerten (auf 1) und zu rationalisieren.
Dies ermöglicht es Ihnen auch, Ihre Entscheidungen gegenüber dem Kunden gegebenenfalls zu begründen.
Schritt 4 - Schreiben Sie die technischen Spezifikationen.
Wie bei den funktionalen Specs sollten Sie auch hier eine klare und prägnante Sprache verwenden.
Planen Sie außerdem ein Glossar am Anfang oder am Ende des Dokuments ein, um technische Begriffe zu definieren und sicherzustellen, dass sie für alle verständlich sind.
Wir bieten Ihnen eine Vorlage für eine Projektspezifikation, die Sie ausfüllen können, um Ihnen eine Arbeitsgrundlage zu geben.
Geben Sie die funktionalen Spezifikationen an und stellen Sie für jede Spezifikation die empfohlene(n) technische(n) Lösung (en) und die erforderlichen Ressourcen dar.
☝️ Erstellen Sie bei umfangreicheren Projekten die technischen Spezifikationen für das Projekt separat als Anhang zur Leistungsbeschreibung mit einem Inhaltsverzeichnis.
Weisen Sie Ihrem Dokument eine Nummer und Verantwortliche zu, um die Nachvollziehbarkeit zu gewährleisten.
Seien Sie spezifisch!
Bevor Sie Ihr Lastenheft zur Bestätigung an den Kunden zurückschicken, sollten Sie sich die Zeit nehmen, Ihre technischen Spezifikationen von Ihrem multidisziplinären Team gegenlesen zu lassen.
Ist es klar und ausreichend detailliert? Fehlen wichtige Informationen?
Versetzen Sie sich in die Lage einer Person ohne die technischen Fähigkeiten und nehmen Sie letzte Anpassungen vor.
Denn dieses Dokument ist sowohl eine Unterstützung für Ihr Projektteam als auch ein für Sie verbindliches Dokument, das die Zustimmung des Auftraggebers besiegelt.
Artikel übersetzt aus dem Französischen