Programų sistemų inžinerija - Matematikos ir Informatikos fakultetas ...

Programų sistemų inžinerija8. Komandinis programų kūrimo procesasDokumentavimas yra labai svarbi kiekvieno programinio produkto dalis – galbūt netsvarbesnė už programos kodą. Ir geriausia dokumentuoti kažkurią sistemos funkciją tuoj pat pojos suprojektavimo. Jei dokumentacija bus paruošta anksčiau nei užbaigta sistemos projektinėspecifikacija – reikės atlikti daug dokumentacijos pakeitimų, jei dokumentavimo darbai bus perilgai atidėliojami – tada tai užims daugiau laiko, nes reikės prisiminti projektavimo metupriimtus sprendimus.Kokia turi būti gera vartotojo dokumentacija (“vartotojo vadovas”):• Pirmiausia, reikia rašyti ne tai, kokia sistema buvo sukurta, o tai, ko labiausiai reikiavartotojui, dirbančiam su sistema: kaip vartotojui pradėti naudotis produktu, ką vartotojas galidaryti su produktu, kaip jam surasti reikiamą informaciją;• Siūloma naudoti: Terminų žodyną; Klaidų pranešimų skyrių ir pan.; Esminių skyriųrodyklę; Detalų turinį;• Kitos rekomendacijos: Rašyti trumpus sakinius; Naudoti paprastus žodžius ir frazes;Naudoti sąrašus bei struktūrizuoti informaciją;• Dokumentas turi būti gerai skaitomas ir suprantamas.Iš pradžių parengiamas dokumentacijos eskizas, vėliau jis konkretizuojamas. Vartotojodokumentacija turi būti peržiūrima vieno ar kelių komandos narių. Peržiūrint, turi būti paliesti šieaspektai:• Dokumento struktūra: ar dokumente išdėstytas produkto turinys, ar tai, ką vartotojas galidaryti su šiuo produktu?• Dokumento terminologija: ar vartotojas turi turėti specialių žinių, kad galėtų efektyviainaudotis dokumentu?• Dokumento turinys: ar dokumentas apima visą produktą?• Kruopštumas: ar metodai ir procedūros veikia taip, kaip apibrėžta dokumente?• Skaitomumas: ar dokumentas lengvai skaitomas?• Suprantamumas: ar gali asmenys neprofesionalai suprasti tai, kas parašyta dokumente?Gera praktika laikoma, kai vartotojo dokumentacijos dokumentas duodamas peržiūrėtivartotojams, anksčiau nesinaudojusiems šia sistema ir jų prašoma atlikti veiksmus su sistema,aprašytus vartotojo dokumentacijoje.AptarimasAptarimas yra galutinis žingsnis TSP procese. Jame peržiūrimas visas padarytas darbastam, kad įsitikinti, jog mes užbaigėme visus uždavinius ir užrašėme visą reikalingą informaciją(užpildėme visas formas). Analizuojama, kas buvo padaryta ciklo eigoje su tikslu ištirti, kassekėsi, o kas – nelabai, ir padaryti išvadas, kaip kitą kartą atlikti darbą geriau.Mokymo medžiaga 114