W poszukiwaniu bożków dokumentacji

"Jeden z moich profesorów na Politechnice Gdańskiej mawiał "Programistom płacimy za pisanie dokumentacji, pisanie kodu to dla nich przyjemność!". Rzeczywistość jednak okazuje się brutalna... dokumentacja to ostatnie z czym chcielibyśmy mieć cokolwiek wspólnego w projekcie. Bo nuda, bo word, bo zupełnie inny flow, bo nie widać kto co zmienił... Na tej sesji chciałbym Wam pokazać że można inaczej, że dokumentacja może być łatwa i przyjemna - jak napisanie maila, jak kilka linijek kodu. Takie przynajmniej są założenia AsciiDoc (jak i innych: Markdown, RestructuredText) - prosta, minimalna, nieinwazyjna składnia, tekstowe dokumenty, czytelne bez dodatkowych narzędzi. Podczas sesji pragnę przybliżyć AsciiDoc'a (oraz cały ekosystem narzędzi z nim związanych). Ale przede wszystkim chciałbym Was zarazić najlepszym możliwym sposobem dokumentowania, notowania - za pomocą prostych i ogólnodostępnych narzędzi, łatwo współdzieląc efekty naszej pracy. nie wychodząc poza nasz codzienny, programistyczny rytuał." Gościem spotkania będzie Jakub Marchwicki