dijous, 25 de març de 2010

La documentació és la clau

Sóc una fervent defensora de les bones documentacions... És clar que el següent acudit, fa un bon resum del què acostuma a passar...
Vist a través de Geek and Poke

Crec que una bona documentació és una peça clau en qualsevol projecte:

- El codi es pot reutilitzar de forma senzilla, sense haver de ser duplicat
- El desenvolupament del projecte i el seu ús és més ràpid i eficaç
- S'eviten errors provocats per una mala configuració o mal ús
- El coneixement del projecte està a l'abast de tothom que es llegeixi (i entengui) la documentació. Per tant, ningú és imprescindible.
- Com que el coneixement està documentat, és relativament ràpid incorporar nous recursos humans productius al projecte.
- Modificacions en el projecte, passat un temps, són possibles sense complicacions.

Tot són avantatges.

L'únic problema? No s'acostuma a donar suficient importància a la documentació i per tant, deixa de ser una eina eficaç, per convertir-se en un munt de paraules i gràfics antiquats que no aporten la informació necessària i que poden donar lloc a confusions i pèrdua de temps. I en el món real, el temps costa molts diners!

1 comentari:

Anònim ha dit...

No és el mateix trigar uns minuts a entendre un bon document que trigar unes hores en intentar saber el que posa, per el fet de no tenir uns bons comentaris llegibles.
Una bona documentació com informar bé, resulta beneficiós per tothom.

Mª Rosa.