#56 Tech Writer robi inżynierię oprogramowania, czyli dobre praktyki prosto od Google

Witamy w podcaście Tech Writer Koduje, w którym mówimy o technicznej stronie tworzenia dokumentacji w IT. W dzisiejszym odcinku moim gościem jest Paweł Kowaluk. Paweł Kowaluk Dobry wieczór Państwu, dobry wieczór Panie Redaktorze. Paweł jest ekspertem od inżynierii oprogramowania, w szczególności od inżynierii oprogramowania w firmie Google, ponieważ przeczytał jedną książkę i chciał się z nami podzielić swoimi wnioskami, uwagami i obserwacjami po lekturze właśnie tejże książki. Chciałem, panie redaktorze, sprostować jedną rzecz, bo ja przeczytałem jedną książkę Google'a i przeczytałem tak naprawdę dwie książki, bo jeszcze przeczytałem naszą szkapę. Okej. Ja przeczytałem jeszcze o psie, który jeździł koleją i Janko Muzykanta. Nieźle. Ale tam nic nie było o inżynierii oprogramowania, z tego co pamiętam.

No nie proszę, nie proszę. Ja też nie. Jeszcze, jeszcze. Jeszcze chyba jedna ważna rzecz, która jest w kontekście dokumentacji tutaj warta zaznaczenia, to jest to, że dokumentacja powinna mieć ownera. Jest to dość istotna sprawa, bo dokumenty, które nie mają takiego jasnego właściciela, żyją własnym życiem. No i nawet jak masz takiego ownera, to możesz właśnie chociażby te powiadomienia ustawić, o których ty mówiłeś, że przychodzi powiadomienie do ownera, ej słuchaj, przez trzy miesiące tam nic nie zmieniałeś, może czas, żeby przejrzeć, albo jeśli to jest celowe, no to zignoruj tą wiadomość. Więc mi się wydaje, że ownership to jest istotna sprawa bardzo. Sprawa ownera, właśnie nie wiem czy to było wymienione w tej książce, czy to nie było wymienione, ale w dokumentacji Google'a, na stronie jest dokumentacja, widać kto jest ownerem, znaczy kto jest jakby tam autorem, widać jakąś tam osobę.