Testdokumentation im Softwaretest (Beispiel)

Was ist Testdokumentation?

Die Testdokumentation umfasst alle Artefakte, die vor oder während des Softwaretests erstellt werden. Sie unterstützt das Testteam bei der Aufwandsschätzung, der Ressourcenverfolgung und der Fortschrittskontrolle sowie bei der Sicherstellung einer ausreichenden Testabdeckung. Die Testprotokolle und -berichte bilden einen vollständigen Satz von Dokumenten, mit denen Testplanung, Testdesign, Testdurchführung und Testergebnisse beschrieben und dokumentiert werden können.

👉 Melden Sie sich für ein kostenloses Live-Softwaretestprojekt an

Warum ist eine formale Prüfung notwendig?

Für Einsteiger liegt die Annahme nahe, dass Testen bedeutet, verschiedene Codeabschnitte willkürlich auszuführen und die Ergebnisse zu überprüfen. In der Praxis ist Testen jedoch ein sehr formaler Prozess, der detailliert dokumentiert wird. Die Testdokumentation erleichtert die Planung, Überprüfung und Durchführung von Tests und gewährleistet deren Nachvollziehbarkeit.

Der Grad der Testformalität hängt ab von:

• Die Art der zu testenden Anwendung (AUT).
• Von Ihrer Organisation befolgte Standards.
• Die Reife des Entwicklungsprozesses.

Testaktivitäten dauern typischerweise zwischen 30% und 50% des gesamten Softwareentwicklungsaufwands. Dokumentationen helfen dabei, Verbesserungspotenziale im Testprozess zu identifizieren, die in zukünftigen Projekten angewendet werden können.

Welche Arten von Testdokumentation gibt es?

Hier sind die wichtigsten Arten der Testdokumentation:

„In der Praxis werden diese Dokumente in verschiedenen Phasen erstellt – von der frühen Planung (Testrichtlinien, Strategie) bis zur Durchführung und zum Abschluss (Fehler- und Zusammenfassungsberichte).“

Was sind die besten Vorgehensweisen zur Erstellung einer Testdokumentation?

In diesem Abschnitt lernen wir die besten Vorgehensweisen kennen, die zur Erstellung einer Testdokumentation beitragen, und erhalten Beispiele, die Ihnen das Verständnis erleichtern:

• Die Qualitätssicherung frühzeitig in das Projekt einbeziehen: Beziehen Sie das QA-Team von Projektbeginn an ein, damit die Testdokumentation parallel zur Produktentwicklung und den Anforderungen entsteht.
  Ejemplo: Die Qualitätssicherung arbeitet während der Sprintplanung mit, um auf Basis der User Stories erste Testfälle zu entwerfen.
• Dokumente auf dem neuesten Stand halten: Erstellen Sie Testdokumente nicht einfach und vergessen Sie sie dann – aktualisieren Sie sie immer dann, wenn sich Anforderungen oder Funktionen ändern.
  Ejemplo: Wenn sich eine Login-API ändert, aktualisieren Sie umgehend die zugehörigen Testfälle und Ergebnisse.
• Verwenden Sie die Versionskontrolle: Verwalten und verfolgen Sie alle Änderungen an Testdokumenten mithilfe von Versionskontrollsystemen, um Verwirrung und Datenverlust zu vermeiden.
  Ejemplo: Speichern Sie Testpläne in GitHub, um eine übersichtliche Versionshistorie und Rollback-Optionen zu gewährleisten.
• Dokument zur Verdeutlichung und Zweckmäßigkeit: Dokumentieren Sie nur das, was Ihnen und Ihren Stakeholdern hilft, den Testfortschritt und die Ergebnisse zu verstehen.
  Ejemplo: Fügen Sie zusammenfassende Testberichte bei, in denen bestandene, fehlgeschlagene und blockierte Testfälle hervorgehoben werden, zur Überprüfung durch das Management.
• Standardvorlagen verwenden: Verwenden Sie ein einheitliches Format – zum Beispiel Excel- oder Word-Vorlagen –, um die Erstellung und Überprüfung der Dokumentation zu vereinfachen.
  Ejemplo: Verwenden Sie eine Standard-Testfallvorlage mit Feldern für ID, Beschreibung, Vorbedingungen und erwartete Ergebnisse.
• Zentralisieren Sie die Dokumentenspeicherung: Bewahren Sie alle projektbezogenen Dokumente an einem leicht zugänglichen Ort auf, damit die Teammitglieder sie problemlos einsehen oder aktualisieren können.
  Ejemplo: Speichern Sie Testartefakte in einem gemeinsamen Google Drive Ordner, auf den das gesamte QA- und Entwicklerteam Zugriff hat.
• Fügen Sie ausreichend Details hinzu: Vermeiden Sie vage oder unvollständige Informationen; eine detaillierte Dokumentation verbessert das Verständnis und reduziert Fehler bei der Testausführung.
  Ejemplo: Statt „Anmeldung prüfen“ schreiben Sie „Überprüfen Sie die Benutzeranmeldung mit gültigen Anmeldeinformationen und die Weiterleitung zum Dashboard wird erfolgreich fortgesetzt“.

Wann sollte man eine Testdokumentation für Softwaretests erstellen?

Hier einige wichtige Punkte, wann Sie Testdokumentation für Softwaretests erstellen sollten:

• Planungsphase: Vor Beginn der Testdurchführung müssen Umfang, Ziele und Teststrategie klar definiert werden.
• Test-Vorbereitungen: Während der Testplanung, um Zeitpläne, Ressourcen und Umgebungsanforderungen effizient festzulegen.
• Anforderungsanalyse: Nach der Anforderungsanalyse, um eine vollständige Abdeckung der funktionalen und nicht-funktionalen Spezifikationen sicherzustellen.
• Designstandardisierung: Vor der Erstellung von Testfällen sollten die Formate standardisiert und die Rückverfolgbarkeit über alle Dokumente hinweg gewährleistet werden.
• Szenario-Dokumentation: Während der Testplanung, um Szenarien, Eingaben, erwartete Ausgaben und Details zu den Testdaten zu dokumentieren.
• Ausführungsbereitschaft: Vor der Testausführung muss die Einsatzbereitschaft der Testumgebung, der Werkzeuge und die Genauigkeit der Dokumentation überprüft werden.
• Auswertung nach der Auswertung: Nach dem Testen werden Ergebnisse, Fehler und Erkenntnisse zur Prozessverbesserung dokumentiert.

Welche Arten von Vorlagen werden für die Testdokumentation benötigt?

Hier sind einige der Vorlagen, die Sie für die Testdokumentation im Softwaretesting benötigen:

Vor- und Nachteile der Testdokumentation

Vorteile

• Der Hauptgrund für die Erstellung von Testdokumentationen besteht darin, Unklarheiten bezüglich der Testaktivitäten zu reduzieren oder zu beseitigen. Sie trägt dazu bei, Mehrdeutigkeiten zu vermeiden, die häufig bei der Aufgabenverteilung auftreten.
• Die Dokumentation bietet nicht nur einen systematischen Ansatz Softwaretest, dient aber auch als Schulungsmaterial für Neueinsteiger im Softwaretestprozess.
• Es dient als gute Marketing- und Vertriebsstrategie, die Testdokumentation zu präsentieren, um einen ausgereiften Testprozess zu demonstrieren.
• Die Testdokumentation hilft Ihnen dabei, dem Kunden innerhalb bestimmter Zeitvorgaben ein qualitativ hochwertiges Produkt anzubieten.
• In Software EngineeringDie Testdokumentation hilft auch bei der Konfiguration bzw. Einrichtung des Programms mithilfe des Konfigurationsdokuments und der Bedienungsanleitungen.
• Die Testdokumentation hilft Ihnen, die Transparenz gegenüber dem Kunden zu verbessern.

Nachteile

• Die Kosten der Dokumentation können ihren Wert übersteigen, da sie sehr zeitaufwändig ist.
• Oft werden sie von Leuten geschrieben, die nicht gut schreiben können oder sich mit dem Stoff nicht auskennen.
• Es ist ermüdend, den Überblick über die vom Kunden gewünschten Änderungen zu behalten und entsprechende Dokumente zu aktualisieren.
• Mangelhafte Dokumentation wirkt sich direkt auf die Qualität des Produkts aus, da es zu Missverständnissen zwischen dem Kunden und dem Unternehmen kommen kann.

Häufige Fehler, die in der Testdokumentation vermieden werden sollten

Hier sind die häufigsten Fehler, die Sie in einer Testdokumentation vermeiden sollten:

1. Vermeiden Sie unklare oder mehrdeutige Testfallbeschreibungen.
2. Die Dokumentation der Testvoraussetzungen und -abhängigkeiten darf nicht vernachlässigt werden.
3. Vergessen Sie nie, die erwarteten Ergebnisse für jeden Test anzugeben.
4. Vermeiden Sie uneinheitliche Formatierungen in verschiedenen Testdokumenten.
5. Verwenden Sie keine vagen oder nicht messbaren Testziele.
6. Die Versionskontrolle für Aktualisierungen der Testdokumentation darf niemals vernachlässigt werden.
7. Vermeiden Sie die Duplikation von Informationen in mehreren Testartefakten.
8. Vernachlässigen Sie nicht die Überprüfung der Dokumentation auf Richtigkeit und Vollständigkeit.

Häufig gestellte Fragen