Was ist QS-Dokumentation und wie können wir ihre Erstellungs- und Wartungskosten senken?

Andrii Hilov, QA-Teamleiter bei ITRex, hat einen weiteren Artikel über Herausforderungen und Fallstricke bei der Qualitätssicherung in Softwareprojekten geschrieben. Dieses Mal befasst sich Andrii mit der Qualitätssicherungsdokumentation und der Rolle, die sie bei der Entwicklung leistungsstarker Software spielt – pünktlich, im Rahmen des Budgets und im Einklang mit Ihren Geschäftszielen.

Hier ist, was er dazu zu sagen hat.

Als QA-Teamleiter bei einem Unternehmenssoftwareentwicklungsunternehmen ITRex bin ich mir der Bestrebungen unseres Kunden, die Softwareentwicklungskosten zu senken und gleichzeitig ein voll funktionsfähiges Produkt pünktlich und mit maximalem Wert auf den Markt zu bringen, vollkommen bewusst.

Obwohl diese Ziele verständlich sind, rate ich davon ab, Ihr QA-Team zu Beginn des Projekts zu entlassen, auch wenn es nicht täglich Fehler findet, obwohl dies eine einfache Option sein könnte, um den Gehaltsscheck zu kürzen und Software-Release-Zyklen zu beschleunigen.

Außerdem empfehle ich Ihnen, während des gesamten Projekts die Best Practices zur Qualitätssicherung zu befolgen, um sicherzustellen, dass Ihre Lösung und alle ihre Funktionen wie erwartet funktionieren und Ihre Cybersicherheit nicht gefährden.

Und eine dieser Praktiken ist die Erstellung und Pflege einer ordnungsgemäßen QS-Dokumentation.

Was genau ist eine Qualitätssicherungsdokumentation? Wie können Sie den größtmöglichen Nutzen aus der Inanspruchnahme von Qualitätssicherungs- und Testdiensten ziehen? Und gibt es eine Möglichkeit, die Kosten und den Aufwand für die Erstellung der QS-Dokumentation zu optimieren und gleichzeitig das Risiko zu minimieren, eine schlecht konzipierte, fehlerbehaftete Anwendung zu entwickeln und das Ganze von Grund auf neu erstellen zu müssen?

Lass es uns herausfinden!

Einführung in die QS-Dokumentation

Die Qualitätssicherungsdokumentation ist eine Sammlung von Dokumenten und Artefakten, die von einem Qualitätssicherungsteam während des Softwareentwicklungs- und Testprozesses erstellt und gepflegt werden.

Es kann verschiedene Dokumente umfassen, die die Teststrategie, Testpläne, Testfälle, Testskripte, Testdaten, Testprotokolle, Fehlerberichte und jede andere Dokumentation im Zusammenhang mit den QS-Aktivitäten beschreiben. Diese Dokumente erleichtern die Kommunikation zwischen QA-Teammitgliedern, bieten Richtlinien für Tests und helfen bei der effizienten Identifizierung und Lösung von Problemen.

Daher spielt die QS-Dokumentation eine entscheidende Rolle bei der Sicherstellung der Qualität und Zuverlässigkeit von Softwareprodukten – und das ist das Hauptziel, das unsere Kunden verfolgen.

Welche QS-Dokumente werden in Softwareprojekten verwendet?

In diesem Artikel geben wir Ihnen einen kurzen Überblick über Qualitätssicherungsdokumente, die das Rückgrat der Testdokumentation in einem Softwareentwicklungsprojekt bilden:

• Ein Testplan ist ein QS-Dokument, das den Gesamtansatz, die Ziele, den Umfang, die Ressourcen und den Zeitplan der Softwaretestaktivitäten beschreibt. Vereinfacht gesagt umfasst es Folgendes:

1. Der Name und die Beschreibung eines Projekts, einschließlich der Arten der getesteten Apps und ihrer Kernfunktionalität
2. Die bevorzugten Testmethoden (manuell, automatisiert, gemischt) und Testtypen (neue Funktionen, Integrationen, Kompatibilität, Regression usw.)
3. Die Funktionen, die getestet werden müssen, sowie ein ungefährer Zeitplan für jede Testaktivität
4. Optimale Teamzusammensetzung
5. Ein Überblick über Risiken und Probleme, die während des Testprozesses auftreten können
6. Eine Liste der Testdokumente, die Ihr QA-Team während des Projekts verwenden wird

Als Faustregel gilt, dass Sie zu Beginn eines Softwareprojekts einen Testplan erstellen sollten, wenn Ihr IT-Team funktionale und nichtfunktionale Anforderungen für eine Softwarelösung definiert, einen geeigneten Technologie-Stack und eine geeignete Projektmanagementmethodik auswählt und eine Projekt-Roadmap erstellt.

Normalerweise dauert es bis zu drei Tage, einen einfachen Testplan ohne Testfälle zu erstellen und zu überprüfen.

• Testfälle beschreiben spezifische Testszenarien, einschließlich der Eingabedaten, erwarteten Ergebnisse und auszuführenden Schritte. Testfälle dienen dazu, die Funktionalität, Leistung oder andere Aspekte eines Softwareprodukts zu überprüfen. Bitte beachten Sie, dass Testfälle sowohl von manuellen Testdiensten als auch von QA-Automatisierungsdienstteams verwendet werden. Auf diese Weise stellen Sie eine maximale Testabdeckung sicher, sodass im Produktionscode keine Fehler auftreten.

Obwohl ein erfahrener QA-Ingenieur in nur zehn Minuten einen Testfall auf hohem Niveau schreiben könnte, könnte die Anzahl der Testfälle für ein mittelgroßes Projekt leicht 4.000 überschreiten (und es werden noch mehr). Multiplizieren Sie diese Zahl mit dem durchschnittlichen Stundensatz für QS-Ingenieure im mittleren Durchschnitt (65 US-Dollar pro Mannstunde für den nordamerikanischen Markt), und Sie erhalten eine beeindruckende Zahl.

• Checklisten sind prägnante, detaillierte Listen von Aktionen oder Aufgaben, die während des Testprozesses abgeschlossen oder überprüft werden müssen. Daher umfasst eine Checkliste in der QA-Dokumentation normalerweise eine vollständige Auflistung der Funktionsmodule, Abschnitte, Seiten und anderen Elemente einer App oder eines cyber-physischen Systems, die die Aufmerksamkeit eines QA-Teams erfordern.

In kleineren Projekten können Checklisten detaillierte Testfälle erfolgreich ersetzen (dazu später mehr).

• Testskripte sind Codeblöcke, die mit bestimmten Testtools oder Frameworks wie Selenium, Appium und Cucumber geschrieben wurden. Diese Skripte automatisieren die Ausführung von Testfällen und machen den Testprozess effizienter – insbesondere in großen und komplexen Softwareprojekten wie mandantenfähigen SaaS-Systemen und beliebten B2C-Apps, die häufig aktualisiert werden und bei denen selbst kleinste Fehler die Benutzererfahrung negativ beeinflussen können .
• Testdaten sind die Daten, die von QA-Ingenieuren verwendet werden, um die Leistung, Funktionalität, Zuverlässigkeit und Sicherheit einer Softwarelösung unter verschiedenen Bedingungen zu bewerten. Es kann Beispieleingabewerte, Randbedingungen und verschiedene Szenarien umfassen. Beispielsweise kann Ihr QA-Team positive und negative Testdaten verwenden, um zu überprüfen, dass für den Zugang zu einem Softwaresystem nur korrekte Anmeldeinformationen verwendet werden dürfen. Ebenso können Testdaten verwendet werden, um Altersbeschränkungen in bestimmten Arten von Apps umzusetzen oder zu untersuchen, wie eine Anwendung mit erhöhter Arbeitslast umgeht.
• Testprotokolle dokumentieren den Testausführungsprozess, einschließlich Datum und Uhrzeit der Testdurchführung, der Zusammenfassung der ausgeführten Testfälle, der von Ihrem QA-Team erzielten Ergebnisse, Screenshots und aller während des Tests festgestellten Probleme oder Beobachtungen. Ein Testprotokoll ist eine wichtige Informationsquelle zur Verfolgung des Testfortschritts, zur Identifizierung von Mustern oder Trends in Testergebnissen und zur Bereitstellung einer historischen Aufzeichnung der Testaktivitäten. Es hilft dabei, Probleme effizient zu identifizieren und zu lösen und dient als Referenz für zukünftige Testbemühungen oder Audits.
• Fehler- oder Fehlerberichte sind Testdokumente, in denen während der Qualitätssicherungsaktivitäten festgestellte Fehler und Probleme detailliert beschrieben werden. Sie beschreiben insbesondere die erkannten Fehler, deren Schweregrad und Priorität sowie die Bedingungen, unter denen die Fehler auftreten. Ein QA-Manager verwendet Fehlerberichte, um Softwaretestspezialisten Aufgaben zuzuweisen und deren Status zu verfolgen.
• Eine Rückverfolgbarkeitsmatrix bildet die Beziehung zwischen Testfällen und Anforderungen oder anderen Artefakten ab. Es trägt dazu bei, sicherzustellen, dass alle Anforderungen angemessen durch Testfälle abgedeckt werden, ermöglicht die Verfolgung der Testabdeckung im gesamten Projekt und eliminiert redundante Testaktivitäten.
• Ein Testabschlussbericht fasst die in einem Projekt durchgeführten Testaktivitäten zusammen, einschließlich des Testausführungsstatus, der Anzahl der ausgeführten Testfälle, gefundener Fehler und aller ausstehenden Aufgaben.

Warum ist eine QS-Dokumentation wichtig?

Eine Qualitätssicherungsdokumentation trägt dazu bei, genau die Ergebnisse zu erzielen, die der Kunde und das Softwareentwicklungsteam erwarten.

Dies wird durch eine Kombination von Faktoren erreicht, darunter die folgenden:

1. Die Qualitätssicherungsdokumentation bietet klare Anweisungen und Richtlinien, die Softwaretestspezialisten befolgen können, um Aufgaben konsistent auszuführen, Abweichungen zu reduzieren und die Gesamtqualität von Produkten oder Dienstleistungen zu verbessern.
2. Die Qualitätssicherungsdokumentation verringert die Wahrscheinlichkeit, dass kritische Mängel und Fehler in Softwarelösungen spät im Entwicklungsprozess entdeckt werden, und spielt daher eine entscheidende Rolle bei der Budgetkontrolle. QA-Experten gehen davon aus, dass die Kosten für die Behebung von Fehlern mit jeder Projektphase exponentiell ansteigen und von 3X für die Design-/Architekturphase bis 30X und mehr für die Bereitstellungsphase reichen.
3. Die Qualitätssicherungsdokumentation trägt dazu bei, die Einhaltung der gesetzlichen Anforderungen und Standards sicherzustellen, die Ihr Unternehmen erfüllen muss, indem sie Audits vereinfacht und Nachweise für etablierte Prozesse, Verfahren und Qualitätskontrollen liefert.
4. Durch die Dokumentation von Verfahren, Kontrollen und Risikobewertungsprozessen hilft die Dokumentation von Softwaretests Unternehmen dabei, potenzielle Risiken zu erkennen und vorbeugende Maßnahmen zu ergreifen, um deren Auswirkungen auf ihr Geschäft und die Kundenzufriedenheit zu minimieren.
5. Neue Mitarbeiter können auf Ihre QS-Dokumentation zurückgreifen, um die Qualitätsprozesse und -verfahren in einem Softwareprojekt zu verstehen, wodurch die Lernkurve verkürzt und eine konsistente Schulung im gesamten Unternehmen sichergestellt wird.
6. Durch die Dokumentation von Nichtkonformitäten, Korrekturmaßnahmen und gewonnenen Erkenntnissen können Unternehmen Bereiche mit Verbesserungspotenzial identifizieren und Änderungen zur Steigerung von Effizienz und Qualität umsetzen.
7. Gut dokumentierte Qualitätssicherungsprozesse und -verfahren können das Vertrauen der Kunden in die Produkte oder Dienstleistungen Ihres Unternehmens stärken. Eine umfassende Dokumentation von Softwaretests zeigt die Verpflichtung zur Qualität und stellt sicher, dass das Unternehmen über robuste Systeme verfügt, um konsistente und zuverlässige Ergebnisse zu liefern.
8. In Situationen, in denen es zu Rechtsstreitigkeiten oder Produktrückrufen kommt, kann die QS-Dokumentation als wichtiger Beweis dienen. Es kann nachweisen, dass Ihre Organisation etablierte Qualitätsprozesse befolgt, notwendige Vorsichtsmaßnahmen getroffen und ihre Verpflichtungen erfüllt hat.

Wie lange dauert die Erstellung einer QS-Dokumentation?

Eine ehrliche Antwort auf diese Frage wäre: „Es kommt darauf an.“

Insbesondere hängen der Zeitrahmen und die damit verbundenen Kosten von mehreren Faktoren ab, beispielsweise der Größe Ihres Unternehmens und der Komplexität seiner Prozesse, der Branche, in der Sie tätig sind, und der Art der Software, die Sie entwickeln.

Wenn Sie bereits mit Softwareentwicklungsprojekten begonnen haben und über ein internes QA-Team verfügen, können Sie möglicherweise die vorhandene QA-Dokumentation für neue Projekte wiederverwenden. Auch die Verwendung von Vorlagen und speziellen Tools zum Erstellen und Pflegen von Softwaretestdokumentationen, wie z. B. Projektmanagement- und Wiki-Software, ist hilfreich.

Benötigen Sie immer eine QS-Dokumentation – und ist es möglich, deren Erstellungs- und Wartungskosten zu senken?

So nützlich die Qualitätssicherungsdokumentation auch sein mag, sie kann aufgrund des zusätzlichen Aufwands und des Personals, die für ihre Erstellung und Pflege erforderlich ist, die Kosten für Softwareprojekte erhöhen.

Dies könnte ein Problem für Start-ups sein, die mit knappen Mitteln arbeiten, oder für Unternehmen, die sich in Zeiten der Rezession einer digitalen Transformation unterziehen.

Benötigt dann jede Art von Softwareprojekt eine sehr detaillierte QS-Dokumentation – und ist es möglich, die damit verbundenen Kosten zu senken?

Berücksichtigen Sie die folgenden Faktoren, um den besten Ansatz für die Erstellung von QS-Dokumenten zu ermitteln:

• Projektgröße und Budget . Bei Projekten mit kleinem Budget und kurzfristiger Laufzeit (es sei denn, es handelt sich um hochinnovative und technische Projekte, die von großen IT-Teams ausgeführt werden) besteht kein Grund, den Dokumentationsprozess zu verkomplizieren, sodass Ihr QS-Team sich für Checklisten anstelle detaillierter entscheiden kann Testfälle. Was das Testplandokument betrifft, das die gesamte Teststrategie festlegt, können wir auch darauf verzichten, es zu schreiben, wenn dafür kein Budget vorhanden ist oder wenn das Projekt kurzfristig ist und keine Spitzentechnologien beinhaltet.
• Größe und Erfahrung des QA-Teams . Je mehr QA-Ingenieure am Projekt beteiligt sind und je weniger Erfahrung sie in der Qualitätssicherung haben, desto schwieriger ist es, den Testprozess zu steuern. Daher benötigen Sie eine umfassende Qualitätssicherungsdokumentation, um die Teammitglieder auf dem gleichen Stand zu halten. In solchen Fällen ist es ratsam, auf Testfälle anstelle von Checklisten zu setzen, um die Aufgaben effektiver auf der Grundlage ihrer Erfahrung und ihres Wissens auf die Ingenieure zu verteilen, und erfahrenere QA-Spezialisten, die normalerweise höhere Stundensätze haben, in die Testfallerstellung einzubeziehen.
• Agile vs. Wasserfall-Ansatz für das Projektmanagement . Während das ITRex-Team in diesem Blogbeitrag die wichtigsten Unterschiede zwischen Agile- und Wasserfall-Methoden zusammengefasst hat, ist es erwähnenswert, was die beiden Ansätze im Hinblick auf die Qualitätssicherung unterscheidet. In Waterfall werden Softwaretests zum Schluss gespeichert, was bedeutet, dass Ihr QA-Team Tests erst dann durchführt, wenn der Codierungsteil zu 100 % abgeschlossen ist. Aus offensichtlichen Gründen ist dies ohne eine ordnungsgemäße Qualitätssicherungsdokumentation, die während der Anforderungserhebungsphase erstellt werden sollte, nicht möglich. Bei Agile, wo IT-Teams dazu neigen, kleinere Softwareteile iterativ zu erstellen und den Code am Ende jedes Zyklus zu testen, wird eine kreative, umfassende QA-Dokumentation im Voraus nicht bevorzugt. Dennoch empfehle ich Ihnen, einen Testplan zu schreiben, um die aktuelle Situation besser an die Erwartungen des Kunden und der Softwareentwickler anzupassen.

Insgesamt könnte eine QA-Dokumentation für jedes Softwareentwicklungsprojekt von Vorteil sein, unabhängig von der Komplexität und Größe.

Als kundenorientiertes Unternehmen sind wir jedoch jederzeit bereit, unter Berücksichtigung Ihrer Ziele und Ihres Budgets Lösungsvorschläge zu machen.

Wenn Sie sich nicht sicher sind, ob Sie für Ihr Projekt eine umfassende Qualitätssicherungsdokumentation erstellen müssen und qualifizierte QS-Ingenieure suchen, denen Sie diese Aufgabe anvertrauen können, wenden Sie sich an ITRex! Wir stellen sicher, dass Sie eine leistungsstarke, fehlerfreie Softwarelösung pünktlich, im Rahmen des Budgets und entsprechend den Spezifikationen auf den Markt bringen!

Ursprünglich veröffentlicht unter https://itrexgroup.com am 30. Juni 2023.