Dokumentationspaket

• Bedeutung eines Pakets in der Dokumentation
  • Was in ein Paket aufgenommen werden kann
• Ein Paket ist kein Ordner
• Ein Paket kann Datensätze schützen
  • Ändern eines gesperrten Pakets
  • Die Sperre gilt nicht für den Status
• Verwandte Datensätze

Ein Paket ist im Allgemeinen eine Gruppe von Datensätzen, die eine logische Verbindung teilen.

Ein Paket ermöglicht das gemeinsame Arbeiten mit der gesamten Gruppe oder schützt Objekte. Pakete sind entweder allgemein oder für einen bestimmten Anwendungsfall vorgesehen – typischerweise zur Datenarchivierung und zum Datenschutz.

Bedeutung eines Pakets in der Dokumentation

Ein Paket ermöglicht das Erstellen eines Sets von Datensätzen, an denen ein Benutzer gemeinsam arbeiten muss oder die eine logische Verbindung aufweisen.

Beispiele für Pakete:

• Ein Set von Informationen und verschiedenen Datensatztypen, das einem Lieferanten als Spezifikation für einen Unterauftrag zur Verfügung gestellt wird
• Ein Set von Anforderungen, die im Rahmen eines bestimmten Releases (Streams) umgesetzt werden.

Was in ein Paket aufgenommen werden kann

Im Allgemeinen kann jede beliebige Dokumentation in ein Paket eingefügt werden. Normalerweise werden jedoch nur Datensätze aufgenommen, die in direktem Zusammenhang stehen. Typischerweise werden maximal 5 Typen hinzugefügt.
Pakete unterstützen Inhalte wie:

• Informationen
• Anforderungen
• Assets — z. B. Testproben, die zusammen mit Testergebnissen archiviert werden
• Protokolle — typischerweise in einem Paket, das die Durchführung eines bestimmten Sets von Tests dokumentiert
• Tests
• Aufgaben
• Analytische und Produktdokumentation
• Entscheidungen
• Probleme — typischerweise verwendet, um Pakete mit Problemen aus Tests zu erstellen, die einer Abteilung oder einem Lieferanten zur Behebung übergeben werden.

Ein Paket ist kein Ordner

Obwohl ein Paket einem Ordner ähnelt, gibt es einen grundlegenden Unterschied. Ein Ordner wird allgemein als Speicherort eines Datensatzes oder einer Datei verstanden, wobei sich jeder Datensatz in einem spezifischen Ordner befindet. Pakete hingegen bilden keine exklusiven Speicherorte. Ein einzelner Datensatz kann in einer beliebigen Anzahl von Paketen enthalten sein.

Ein Paket kann Datensätze schützen

Ein Paket kann eine Sperre erstellen, die Änderungen an den darin enthaltenen Datensätzen verhindert. Dies ist besonders typisch für Archivpakete, die Datensätze in der Form bewahren sollen, in der sie eingefügt wurden. Eine Sperrung ist jedoch auch in vielen anderen Fällen sinnvoll, typischerweise:

• Ein Dokumentationspaket, das einem Lieferanten zur Verfügung gestellt wird, stellt durch die Sperrung sicher, dass intern niemand mehr seinen Inhalt ändert. Dies verhindert ein Szenario, in dem das interne Projektteam mit einer anderen Dokumentation arbeitet als der Lieferant.
• Ein Paket mit Problemen, die bei der Übergabe ungelöst geblieben sind und Teil der Genehmigungsdokumentation darüber sind, was behoben werden muss.

Ändern eines gesperrten Pakets

Wenn sich herausstellt, dass ein Datensatz in einem Paket korrigiert werden muss, gibt es zwei Optionen:

1. Erstellen einer neuen Version des Datensatzes und Markieren des Originals als ungültig
2. Vorübergehendes Deaktivieren der Datensatzsperre, Vornehmen der Korrektur und erneutes Sperren des Pakets
   Jeder Ansatz ist je nach den Gründen und Folgen der vorgenommenen Änderung sinnvoll.

Die Sperre gilt nicht für den Status

Obwohl ein Paket die darin enthaltenen Datensätze sperrt, sperrt es nicht deren Status. Daher ist es möglich, eine Anforderung in einem Paket als nicht mehr gültig oder ein Problem als behoben zu markieren. Statusänderungen werden archiviert, sodass die Information darüber erhalten bleibt, in welchem Status sich der Datensatz befand, als er in das Paket eingefügt wurde.

Verwandte Datensätze

• Pakete können durch Methodiken unter Verwendung einer Paketdefinition definiert werden. Die Methodik schränkt beispielsweise ein, welche Datensätze in das Paket eingefügt werden können.
• Ein Konfigurationspaket ist ein Spezialfall eines Pakets, das im Konfigurationsmanagement verwendet wird. Es entspricht den Anforderungen von Standards wie SPICE, CMMI und anderen.