Rendszerterv

Tesztelőként az a dolgom, hogy kontrol folyamatként legyek jelen a fejlesztési folyamatban. Ez a feladat kettős. Egyrészt tesztelem a dokumentumokat (statikus tesztelés) és tesztelem magát a szoftvert vagy annak egy részét (dinamikus tesztelés). Mostanában egyre jobban figyelmet fordítok arra, hogy milyen minőségű dokumentumok készülnek el a szoftverfejlesztési folyamatban. Az elmúlt pár hétben komolyabb figyelmet kapott a rendszerterv.

Az én nézőpontomból a rendszerterv maga a terv. Az alapja mindennek. Ebben van minden az elkészítendő szoftverrel kapcsolatos válasz. Ez olyan, mint a műszaki rajz.

Mivel folyamatosan jelzem a munkatársaimnak, hogy problémáim vannak a rendszertervvel úgy gondoltam, hogy az a legjobb ha írok egyet. Ha megjárom azt az utat, amit ők. Kíváncsi vagyok, hogy milyen élmény előállítani egy olyan dokumentumot, amely megfelel az elvárásaimnak. Az elvárásaim:

  • érthető
  • áttekinthető
  • informatív
  • tárgyilagos

Érthető: a megfelelő szakmai nyelvet használja. A fogalmak világosak és a dokumentumon belül mindenhol ugyanazt jelentik. Ha ettől eltérés van, akkor új fogalmat vezetünk be.

Áttekinthető: a dokumentum szerkezete a magasabb absztrakciós szint felől halad az alacsonyabb szint felé. A dokumentum minden egyes része megfelel ennek.

Informatív: ez alatt azt értem, hogy megfelelő radundanciával rendelkezik. A túl alacsony és a túl magas redundancia problémákat okoz.

Tárgyilagos: a tárgyilagosság nekem azt jelenti, hogy a dokumentumban nincsen fölösleges stílusbeli csapongás. A kioktató hangnemet kerülni kell. A követendő irány a Felnőtt - Felnőtt tranzakció (tranzakcióanalízis).

Egyelőre ezek az elképzeléseim és a fentieknek megfelelően írom a doksit. A következő lépés az lesz, hogy odaadom a fejlesztők közül pár embernek, hogy olvassák el, véleményezzék és mondják el nekem, hogy mi az amin módosítanának, hogy könnyebben megértsék a mondandót. Ezzel el akarok indítani egy olyan folyamatot, amelynek a végeredménye, hogy kapunk egy olyan formátumot és szerkezetet, amely biztosítja, hogy megfelelő információtartalommal rendelkező dokumentumok készüljenek el megfelelő gyorsasággal. De ehhez nekem is és a munkatársaimnak is sokat kell tanulni.