Część VIII. Narzędzia do dokumentacji technicznej
A Kłapouchy powiedział pod nosem do siebie — Jakieś sztuczki do pisania. Ołówki i coś tam jeszcze. Mocno przecenione, moim zdaniem. Bzdura. Nic ważnego.
—A.A. Milne, Kubuś Puchatek (tłum. Irena Tuwim)
Nawet najlepiej zaplanowany i prowadzony projekt będzie niezrozumiały bez wsparcia w postaci dobrej dokumentacji. Jeśli nie sporządzimy precyzyjnego opisu podejmowanych kroków, który sugerowałby nowym programistom właściwe działania, nawet najlepiej zaprojektowany produkt szybko może się przekształcić w kod spaghetti. Produkt pozbawiony dokumentacji wyjaśniającej użytkownikom, jak korzystać z jego funkcji, nigdy nie zyska popularności wykraczającej poza wąską grupę osób (zwykle złożoną z samych programistów, ...
Get Java. Praktyczne narzędzia now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
