Archiwum miesiąca: wrzesień 2022

AsciiDoctor – dokumentacja techniczna „na poważnie”

W niemal każdym projekcie innym niż PoC (Proof of Concept) trzeba napisać dokumentację. Mimo że często bagatelizowany, jest to element oprogramowania, który świadczy o profesjonalizmie zespołu, w szczególności w oczach kolejnych członków zespołu, którzy dołączają później do projektu i chcą szybko się w niego wdrożyć. W czasie swojej pracy zauważyłem niestety nieprzyjemną prawidłowość: większość osób przychodzących do projektu oczekuje dobrej dokumentacji, ale później poproszeni o minimalne udokumentowanie czegokolwiek co zrobili zaskakująco nie mają czasu albo chęci :-(.

Czytaj dalej