Se il codice è poesia, la documentazione è prosa

200 words by masci

Perché sarà pur vero che il codice ha l’eleganza del verso, può avere un suo ritmo e la sua espressività, ma senza una buona documentazione che ne spieghi il funzionamento, difficilmente avrete degli utenti soddisfatti.

Se mi avessero detto che avrei finito con lo spendere molto più tempo sulla documentazione di un progetto che sul codice non ci avrei mai creduto, ma era prima di scoprire la semplice e potente implicazione “più documentazione, più utenti, più contributor”.

Durante il talk vedremo quali sono i principii alla base di una buona documentazione e come questa possa fare da volano al successo del vostro progetto.


CONFERENCE

PyCon5

Sat, May 24, 2014

META

Slides

Video

LANG

it