Jaką dokumentację techniczną agencja powinna przekazać przy odbiorze?
Strona działa, faktura zapłacona, a jedynym opisem projektu jest kilka maili i pamięć programisty.
Kontekst pytania
Firma odbiera nową aplikację webową. Wykonawca uważa, że kod mówi sam za siebie, a instrukcja dla redaktorów to zbędny luksus. Klient obawia się, że bez dokumentacji każdy kolejny wykonawca będzie zaczynał od kilku tygodni domyślania się, jak to wszystko działa.
Oczekujemy od ekspertów odpowiedzi na pytania:
- Jakie dokumenty powinny być częścią odbioru projektu?
- Jak zapisać obowiązek ich przygotowania w umowie?
- Jak sprawdzić, czy dokumentacja jest użyteczna, a nie tylko obszerna?
1 odpowiedź specjalisty
- D
Dawid Głódź Zweryfikowany ekspert
Ekspert SEO
Dawid jest ekspertem SEO oraz właścicielem serwisów opiniotwórczych, które pomagają czytelnikom porównywać firmy, usługi i produkty, zanim podejmą decyzję. Na co dzień zajmuje się pozycjonowaniem stron, widocznością lokalną w Google i budowaniem autorytetu marek w sieci. Wie, co naprawdę wpływa na pozycję firmy w wynikach wyszukiwania, dlatego w swoich publikacjach stawia na jasne kryteria, rzetelną analizę i praktyczne wnioski, które czytelnik może od razu wykorzystać.
Oczekiwałbym co najmniej czterech rzeczy: opisu technologii i sposobu uruchomienia projektu na nowym serwerze, listy wszystkich kont i usług zewnętrznych, z których korzysta aplikacja, krótkiej instrukcji dla osób edytujących treści oraz opisu nietypowych rozwiązań, których nie da się odczytać z samego kodu.
W umowie wpisałbym dokumentację jako element odbioru, a nie dodatek, i powiązał z nią ostatnią płatność. Bez tego każdy wykonawca pod koniec projektu ma ważniejsze sprawy. Użyteczność najlepiej sprawdzić praktycznie: dać instrukcję redakcyjną osobie, która nie uczestniczyła w projekcie, a dokumentację techniczną pokazać niezależnemu programiście i zapytać, czy potrafiłby na jej podstawie przejąć projekt. Sto stron ogólników jest gorsze niż pięć konkretnych.
Odpowiedź z 31 października 2026