Néhány dolog, amire érdemes figyelni, ha functional design-okat szerkesztünk
Header-ök a szövegben
Bár a dokumentumban ez nem látszik, minden egyes header kap egy tag-et a Genessis-ben, amivel értelemszerűen egy ID-is jár. Hogy ezt hogy tudjuk megnézni, arról bővebben az ID ütközések feloldásánál.
Requirement-ek áthelyezése másik dokumentumba
Áthelyezéskor célszerű megőrizni a tesztelhető requirementek ID-jét, hiszen így nem kell átírni a unit testek referenciáit. Ezt a következőképp tehetjük:
Átmásoljuk a functional design adott részét. (Elvileg a dokumentumok egymástól távoli számoktól kezdik az ID-k kiosztását, így nem kell aggódni amiatt, hogy az új dokumentumban már szerepel ez az azonosító.)
Ezután a régi dokumentumban eltávolítjuk a másolt részekről a tag-eket. Ha ezt nem tesszük meg, akkor ugyanaz az ID két helyen is szerepelni fog. (A tapasztalatok szerint a sima törlés nem feltétlen elég, a tag bennmaradhat a dokumentumban, így törlés előtt el kell távolítani)
Ha a build duplikált ID-t mutat
Ebben az esetben a Genesis nem frissül, a build pedig nem írja ki, hogy hol szerepelnek az adott ID-k, így problémás lehet megtalálni. Ha keresnünk kell, akkor a legegyszerűbb a docx fájlokat kicsomagolni (a docx tulajdonképpen több xml fájl becsomagolva) és a \word\document.xml fájlban megkeresni. A tagek alakja a dokumentumban:
Header: GENESIS_H_”ID”
Requirement group: GENESIS_RG_”ID”
Testable: GENESIS_R_”GroupID”_”ID”_NT_REQ
Not testable: GENESIS_R_”GroupID”_”ID”_REQ
Nem sokkal a tag után szerepel maga a szöveg is, így megtalálhatóak a problémás részek. Ugyanígy, ha egy header tag ID-jére vagyunk kíváncsiak, akkor megkeressük a szöveget az xml fájlban, a tag-et pedig nem sokkal előtte találjuk.
