[Lifeoutoffb] Perchè la documentazione dei progetti software…

Nachricht löschen

Nachricht beantworten
Autor: Cristiano Longo
Datum:  
To: Reclamare indipendenza dall'oligarchia del web
Betreff: [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 ...