Discussione su questo Post

Avatar di User
Avatar di Giorgio Trono

Renderei questa lettura obbligatoria per tutti coloro che lavorano nell'ufficio compliance. ("Ma perché non leggono la policy che abbiamo scritto?!?!")

Expand full comment
Avatar di Davide Tarasconi

Da persona che ha fatto sviluppo software e cresciuto a pane e RTFM, sono ahimé nella minoranza di persone che leggono la documentazione, e nella ulteriore minoranza di persone che documentano tutto.

Sono completamente d'accordo sul fatto che la buona documentazione debba essere un compromesso tra l'essere esaustiva ed essere sintetica: la documentazione deve risolvere un problema a qualcuno e a volte è proprio il non essere in grado di empatizzare con quel o quei "qualcuno" la causa di documentazioni criptiche o enciclopediche.

E se proprio tutto fallisce, come ho sentito dire recentemente, scrivere documentazione come minimo servirà a te che la scrivi, per pensare meglio.

Expand full comment
Ancora 6 commenti...

Nessun post