newFile

Cuando un proyecto (de software) uno lo empieza a hacer con otra gente, y uno no sabe
si las ideas sobre la api estan bien o depronto de un día para otro le da a uno por
reescribir toda la API porque descubrió una forma mas linda. O no se tenían coding
guidelines y se establecen. Vale la pena haber hecho una documentación seria?

Ahí miré los casos que ponés. Rails vs la api que mostras ¿Qué proyecto está mas
maduro? ¿La documentación de emacs que tanto riesgo tiene de quedarse obsoleta de un
día para otro?

A mi una wiki me parece una buena forma de empezar a documentar un proyecto en sus
primeras etapas de vida. Cuando no se han realizado compromisos de diseño. Es fácil
de modificar y todos pueden participar.