Temat: dokumentacja projektu
Komplet dokumentacji dla projektów u mnie nie zawsze ale przy ważniejszych projektach składa się:
1. Założenia merytoryczne, analiza opłacalności oraz potrzeby. Wstępny zarys funkcjonalności (opracowuje biznes + analityk).
2. Projekt funkcjonalny, techniczny. Zawiera merytoryczny opis funkcjonalności do wykonania (opracowuje biznes + analityk) oraz techniczny opis funkcjonalności np. przypadki użycia, przepływ, informacje o przechowywanych danych w db (opracowuje analityk + ewentualnie informatyk programista).
3. Dokumentacja techniczna. Zawiera informacje dotyczące kodu i zaimplementowanych funkcjonalności. Dokumentacja tworzona w popularnym dla danej technologii doku (np. javadoc, phpdoc). Tworzona przez programistę i z reguły generowana do postaci HTML.
4. Instrukcja instalacji gotowego narzędzia (powinien tworzyć analityk albo wdrożeniowiec ale u nas kończy się na testerze albo programiście ...).
5. Instrukcja użytkownika (powinien tworzyć analityk albo wdrożeniowiec ale jest tak jak w poprzednim punkcie).
Dodatkowo jeszcze może być generowany changelog z komentarzy przy aktualizacji SVN lub innego popularnego repozytorium i udostępniany wraz z wyprodukowaną aplikacją.
Ostatni projekt był odświeżeniem oprogramowania napisanego z 6-7 lat temu i tu zrobiłem instrukcję użytkownika w postaci zestawu screencast'ów (ok 1h nagrań). Muszę powiedzieć, że wśród użytkowników końcowych przyjęło się lepiej niż instrukcja papierowa która również została zaktualizowana.