Balík dokumentace

• Význam balíku v dokumentaci
  • Co lze vkládat do balíku
• Balík není složka
• Balík může tvořit ochranu záznamu
  • Oprava zamknutého balíku
  • Zámek se nevztahuje na stav
• Související záznamy

Balíky je obecně skupina záznamů, které mají nějakou logickou souvislost

Balík umožňuje společnou práci s celou skupinou nebo objekty chrání. Balíky jsou buď obecné, nebo pro konkrétní použití – typicky pro archivaci dat a jejich ochranu.

Význam balíku v dokumentaci

Balík umožňuje vytvořit sadu záznamů, se kterými uživatel potřebuje nějak společně pracovat nebo které mají logickou souvislost.

Příklady balíků:

• Sada informací a různých typů záznamů předaná dodavateli jako zadání pro subdodávku
• Sada požadavků, které jsou realizovány v rámci konkrétního releasu (streamu).

Co lze vkládat do balíku

Obecně lze vložit do balíku libovolnou dokumentaci. Většinou se ale do balíku vkládají pouze záznamy, které mají přímou souvislost. Obvyklé je tak vkládání max 5 druhů.
Balíky podporují vkládání

• Informací
• Požadavků
• Aktiv - např. testovacích vzorků, které jsou archivovány společně s výsledky testů
• Protokolů - typicky v balíku dokladujícím průběh konkrétní sady testů
• Testů
• Úkolů
• Analytické a produktové dokumentace
• Rozhodnutí
• Problémů - použije se typicky pro vytvoření balíků problémů z testů, který se předá oddělení nebo dodavateli k řešení.

Balík není složka

I když má balík blízko ke složce, je mezi nimi zásadní rozdíl. Složka je obecně chápána jako umístění záznamu nebo souboru s tím, že každý záznam je v jedné konkrétní složce. Balíky naproti tomu netvoří výlučné umístění. Jeden záznam může být v libovolném počtu balíků.

Balík může tvořit ochranu záznamu

Balík může vytvářet zámek zakazující úpravu záznamů, které v balíku jsou. To je typické zejména pro archivní balíky, které mají uchovat záznamy v té podobě, v jaké do něj byly vloženy. Zámek má smysl ale i v mnoha jiných případech, typicky:

• Balík dokumentace předané dodavateli vytvořením zámku zajistí, že interně už obsah balíku nikdo nezmění. Nemůže se pak stát, že by interně projekt pracoval s jinou dokumentací, než dodavatel.
• Balík s problémy, které zůstaly nedořešeny při předání a jsou součástí schvalovací dokumentace o tom, co musí být opraveno.

Oprava zamknutého balíku

Když se ukáže, že je nutné opravit záznam v balíku, jsou dvě možnosti

1. Vytvořit novou verzi záznamu a původní označit za neplatnou
2. Dočasně zrušit zamykání záznamů, vytvořit opravu a balík zase zamknout
   Každý z postupů má smysl, záleží na důvodech a důsledcích prováděné změny.

Zámek se nevztahuje na stav

I když balík zamyká záznamy, které jsou do něj zařazeny, nezamyká jejich stav. Je tedy možné požadavek v balíku označit za už neplatný nebo problém za odstraněný.
Změny stavu jsou archivovány, zůstává tedy i informace, v jakém stavu záznam byl, když byl do balíku vložen.

Související záznamy

• Balíky mohou být metodiky definovány a předepsány pomocí definice balíku. Metodika např. omezuje, které záznamy je možné do balíku vložit.
• Konfigurační balík je speciálním případem balíku používaného v rámci konfiguračního řízení. Odpovídá požadakům standardů jako je SPICE, CMMI a další.