Nowoczesna forma prowadzenia dokumentacji systemu od eVolpe

W dzisiejszym wpisie przyglądamy się usprawnieniu proponowanemu klientom eVolpe w zakresie uporządkowania dokumentacji realizowanego projektu informatycznego.

SRS (z ang. Software Requirements Specification) to dokument zawierający wszystkie zidentyfikowane wymagania wobec powstającego oprogramowania. Stanowi odbicie planowanej architektury systemu i może być uzupełniany o informacje dotyczące sposobu zrealizowania rozpoznanych potrzeb.

W praktyce eVolpe zamiast skomplikowanego pliku tekstowego w wielu przypadkach funkcjonuje rozwiązanie oparte na popularnej Wikipedii. Intuicyjność takiej internetowej encyklopedii, dostępnej w każdej chwili po zalogowaniu na odpowiednie konto, sprawia, iż odnajdywanie informacji jest bardzo wygodne.

W eVolpe w celu utworzenia nowoczesnej platformy udostępniania dokumentacji korzystamy z tzw. MediaWiki. Jest to oprogramowanie  wykorzystywane przez wszystkie wersje językowe Wikipedii, szereg innych projektów Wikimedia Foundation, jak również inne, w pełni niezależnie działające serwisy. Oprogramowanie MediaWiki ma modułową strukturę i bez większych kłopotów może być modyfikowane i ulepszane przez rozszerzenia, które nadają mu nowe funkcje.

Dokumentacja systemu w formie Wiki a metodyka wdrożeniowa

SRS w formie Wiki sprawdza się zarówno we wdrożeniach realizowanych zgodnie z metodyką waterfall, jak i we framework’u SCRUM. W obu przypadkach klienci eVolpe otrzymują dostęp do specyfikacji systemu. Odbywa się to jednak na różnych warunkach w zależności od wybranego przez nich trybu wdrożenia.

Podejście tradycyjne zakłada przekazanie dokumentacji w pliku tekstowym (koniecznie przed rozpoczęciem prac implementacyjnych). Zgodnie z założeniami metodyki waterfall „kartoteka” systemu stanowi formalną podstawę do rozpoczęcia prac nad wdrożeniem oraz specyfikację zatwierdzonego obustronnie rozwiązania. To z zawartych w niej zapisów wywiązuje się firma wdrożeniowa. W przypadku podejścia zwinnego wymagania wobec produktu zmieniają są na bieżąco i w oparciu o aktualne potrzeby użytkowników, a ich postać jest o wiele mniej formalna (User Stories).

Wychodząc naprzeciw oczekiwaniom naszych klientów, którzy także w przypadku prac w SCRUM’ie chcieliby otrzymać przejrzystą dokumentację zamówionego systemu, proponujemy rozwiązanie SRS Wiki! Dodatkowo, dobrą praktyką eVolpe jest przekazywanie przyrostu dokumentacji wraz z przyrostem oprogramowania na koniec każdej z iteracji.

Dokumentacja systemu a User Experience

Wymagania wobec sytemu wraz z informacją o ich zrealizowaniu trafiają do Wiki częściowo automatycznie. Stosowana w eVolpe technologia pozwala na uzupełnienie części informacji bez udziału programistów i analityków. Nasz zespół utworzył odpowiednie skrypty automatyzujące generowanie dokumentacji projektu. Oznacza to, iż struktura informacyjna może być uzupełniana szybko i bez poświęcania na to dodatkowych mocy przerobowych zespołu.

Czytaj więcej tutaj!



mautic is open source marketing automation

Ta strona korzysta z plików cookie. Więcej informacji

The cookie settings on this website are set to "allow cookies" to give you the best browsing experience possible. If you continue to use this website without changing your cookie settings or you click "Accept" below then you are consenting to this.

Close