On 11/10/21 10:18 PM, Juan Manuel Macías wrote:
> [...]
> Sigo pensando que la documentación, y una documentación clara, accesible
> y ordenada, no es que sea importante en cualquier proyecto de software.
> Es que es esencial si quieres llegar a todo tipo de usuarios, porque no
> todo el mundo tiene la obligación de saber leer código. Y cuando digo
> "leer código" me refiero a leerlo bien, conocer el idioma más que el
> lenguaje y no quedarse en cuatro campanadas.
Perdón, no me he explicado bien, Juan Manuel.
Cuando hay alguna novedad, Hans Hagen la anuncia a la lista.
De ConTeXt puede llegar a haber varias versiones en una semana. Siempre
suele haber unas cuantas al mes, al menos. No todas tienen novedades
desde el punto de vista del usuario.
No creo que fuese incluso deseable que se informase a quienes no
desarrollan muy de cerca ConTeXt (son muy pocas personas) de cada cambio
en el código.
> O eso o guardarte tu código para uso personal (incluso el código que
> escribo para mi uso personal lo procuro documentar y ordenar
> profusamente, pero eso ya va en gustos, auque me gusta describir las
> cosas que se me ocurren, y programar es un proceso de mucha
> cavilación donde a veces uno sigue varias vías, descarta unas,
> prefiere otras, etc. Es como llevar un diario).
Creo que eso es distinto, en mi opinión.
Una cosa es comentar todo el código, con la mayor claridad posible.
Porque en un mes (unos meses, como mucho), se vuelve ilegible para quien
lo escribió.
> Otra posibilidad sería convertir tu proyecto en una logia de
> iniciados: que, ojo, es muy respetable, pero estás a años luz de mi
> concepción del software libre.
Las logias de iniciados las hay al repetir siempre los mismos mantras,
con documentación y sin ella.
En concreto, con la informática eso pasa en exceso. Y no sigo justo por
ahí, porque sé que voy muy por libre.
Saludos,
Pablo
----------------------------------------------------
Los artículos de ES-TEX son distribuidos gracias al apoyo y colaboración
técnica de RedIRIS - Red Académica española - (http://www.rediris.es)
------------------------------------------------------
|
