著者: Cristiano Longo 日付: To: Reclamare indipendenza dall'oligarchia del web 題目: [Lifeoutoffb] Perchè la documentazione dei progetti software è diventata così prolissa ma al tempo stesso non esaustiva?
Perchè la documentazione dei progetti software è diventata così prolissa
ma al tempo stesso non esaustiva?
Ho identificato tre delle possibili concause:
- Lirica : nessuno ti dice quello che ti deve dire e basta ma ha la
necessità di farti una bella introduzione dove ti spiega perchè e per
come, e visto che ormai i corpus di documentazione dei prodotti sono
eterogenei e compositi questo si ripete in ogni piccola parte e in ogni
post e sezione
- Epica : le perle sono quando si racconta la genesi del progetto,
romanzata, oppure quando si inventa una storia sulla genesi del
progetto. Un caso ben riuscito davvero è Apache Thinkerpop "Gremlin
realized. The more he did so, the more ideas he created. The more ideas
he created, the more they related."
- il male peggiore sono gli Esempi: puoi fare mille esempi sulla stessa
cosa così troverai mille articoli che ti raccontano della stessa cosa.
Che era bello quando la documentazione era asciutta e informale ...
