Wpis z mikrobloga

  • 6
@SaintWykopek i słusznie. Każdy chce niby tej dokumentacji ale przecież każdy i tak doskonale wie, że nawet jak się pojawi to jednorazowo, nie będzie aktualizowana, i mało kto ją przeczyta. Nie po to są nowoczesne środki porozumienia się żeby pisać do, siebie wielostronicowe listy jak w średniowieczu.
  • Odpowiedz
@oslet: No to wyobraź sobie tłumaczenie tej samej konfiguracji 10 różnym osobom podczas gdy wystarczyło przeczytać te "listy".

Poza tym nie da się zapamiętać wszystkiego, po to jest dokumentacja.

Nie chciałbym z Tobą pracować xD
Każdy poważny inżynier zaczyna od zapoznania się z docsami i API...
  • Odpowiedz
@oslet szczegolnie jest to nieprzydatne w przypadku architektury systemow, rodzaju zaleznosci miedzy elementami. Ale kto by sie tam przejmowal, hit commit i do domku xD
  • Odpowiedz
@oslet: dokumentacja powinna przede wszystkim dotyczyć stabilnych elementów takich jak architektura systemu czy opracowane procesy. Dzięki temu może służyć jako gwarancja stosowania przyjętych praktyk i utrzymania wizji projektu. Nie powinna tym samym zbyt często podlegać zmianom. Brak odpowiedniej dokumentacji promuje chaos w zespole i bałagan w produkcie.
  • Odpowiedz