-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 El 2006-12-30 a las 20:56 +0100, Camaleón escribió:
El 30/12/06, Carlos E. R. escribió:
Sí, si que es problema del programador y del empaquetador, y si puedo "exigirlo", o mejor dicho, pedirlo. Yo no puedo escribir esa documentación porque no conozco el funcionamiento de ese programa. Es muy bonito eso de decir que porque es gratis no se puede pedir absolutamente nada. No estoy de acuerdo.
Hay que hacer las cosas bien.
Hacer las cosas bien (desde mi punto de vista) sería ofrecer tu ayuda en algo que ves que se queda en el aire (por ejemplo, lo relacionado con la ubicación de los ficheros de los hemos hablado -fax.allow y fax.deny- y que no está del todo documentado.
No, porque yo soy perfeccionista y exigente conmigo mismo y no me permito colaborar como documentalista en un proyecto que desconozco, y que ni siquiera uso. Si yo usara ese programa, me lo pensaría. Y no es sólamente la carencia de esos ficheros, es que no encontré un mínimo readme de la estructura de funcionamiento (el readme existente es sobre la compilación). No vi por donde empezar.
documentación, otros la hacen pésima. El hecho de que trabajen de balde no impide que se pueda criticar la falta de documentación. Tan importante para el éxito de un programa es el programa en sí como su documentación. La falta de ella puede ser fallo del progrmador/es, su equipo, el empaquetador, e incluso el distribuidor (Novell).
Para eso estamos nosotros ¿no? No siempre se pueden permitir el lujo de desarrollar una documentación compleja y bien desarrollada, a menudo es una sola persona la que hace todo el trabajo, sencillamente no puede con todo.
De acuerdo que no pueda con todo, pero yo tampoco. No puedo ni con lo que me he ofrecido a hacer, así que no voy a ofrecerme a otros más (y menos en proyectos que no uso). Yo también soy limitado.
Precisamente, uso otro. Esa es la cuestión.
Correcto. Pero criticar un programa porque la documentación no está del todo completa teniendo en cuenta que ha sido desarrollado sin recibir apoyo económico y /o de personal (como pueda tener HylaFAX o Apache, por poner dos ejemplos) pues me parece, excesivo ;-)
Claro que lo puedo criticar, y lo hago. La crítica no es destructiva. El hecho de que algo gratuito esté incompleto no impide el derecho a decir lo que está mal.
Desde el punto del programador, a mi me gustaría realizar una documentación completa y total del programa en el que estuviera trabajando, donde quedaran definidas todas opciones y posibilidades que ofrece, pero entiendo que si somos "dos gatos" en su desarrollo pues no siempre esa opción es posible.
Yo también me he ganado las habichuelas programando, y sé el tiempo que se dedica a la documentación... (nada). Es probable que mi jefe pensara que yo era lento, quizás porque me entretenía en documentar lo que estaba haciendo, para mí y para los que venían detrás. Ya perdía demasiadas horas descifrando lo que mis antecesores habían hecho y ocultado :-/ - -- Saludos Carlos E. R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (GNU/Linux) Comment: Made with pgp4pine 1.76 iD8DBQFFlssItTMYHG2NR9URAlemAJ4v/93l2OfG2j0ICSfvgYLNe6aUXgCdEbXC Rk9s2aTx7m7ZUj+Z2FLb2g4= =ugI6 -----END PGP SIGNATURE-----