Explorar artículos

Saltar a: navegación, buscar
Documentación de programas en Software libre
Del capítulo Licencias en Software libre +
Del libro Software libre +
Elemento de índice [[Documentación de programas en Software libre|Sección 5. ''Documentación de programas'']]
Estado completo  +
Nivel desarrollo 4  +
Nombre página Documentación de programas en Software libre  +
Número capítulo 3  +
Número sección 5  +
Prueba falso  +
Página sección Documentación de programas en Software libre +
Resumen La documentación que viene con un programa La documentación que viene con un programa es parte integrante del mismo, igual que los comentarios del código fuente, como reconoce, por ejemplo en España, la Ley de Propiedad Intelectual. Dado este nivel de integración, parece lógico que se le apliquen las mismas libertades y evolucione de la misma manera que el programa: toda modificación que se haga de un programa requiere un cambio simultáneo y consistente en su documentación. La mayor parte de esta documentación suele estar codificada como ficheros de texto sin formato, ya que se pretende que sea universalmente accesible con un entorno de herramientas mínimo, y (en el caso de los programas libres) suele incluir una pequeña introducción al programa (README o LEEME), instrucciones de instalación (INSTALL), alguna historia sobre la evolución pasada y futura del programa (changelog y TODO), autoría y condiciones de copia (AUTHORS y copyright o COPYING), así como las instrucciones de uso. Todas ellas, menos la autoría y las condiciones de copia, deberían ser libremente modificables según el programa evoluciona. A la autoría sólo se le deberían añadir nombres y créditos, pero sin borrar nada, y las condiciones de copia sólo deberían modificarse si estas mismas lo permiten. Las instrucciones de uso suelen estar codificadas en formatos más complejos, ya que suelen ser documentos más largos y ricos. El software libre exige que esta documentación pueda ser modificada fácilmente, lo que a su vez obliga a usar formatos denominados transparentes, de especificación conocida y procesables por herramientas libres, como son, además del texto puro y limpio, el formato de páginas de manual de Unix, TexInfo, LaTeX o DocBook, sin perjuicio de distribuir también el resultado de transformar esos documentos fuente en formatos más aptos para visualizar o imprimir, como HTML, PDF o RTF (formatos en general más opacos). Sin embargo muchas veces se hace documentación sobre programas por parte de terceros que no han intervenido en el desarrollo. A veces es documentación de carácter didáctico que facilita la instalación y uso de un programa concreto (HOWTOs, COMOs o recetarios), a veces es documentación más amplia, abarcando varios programas y su integración, comparando soluciones, etc., ya sea en forma de tutorial o de referencia. A veces es una mera recopilación de preguntas frecuentes con sus respuestas (FAQs o PUFs). Ejemplo notable es el Proyecto de Documentación Linux [tldp]. En esta categoría podemos también incluir otros documentos técnicos, no necesariamente sobre programas, ya sean las instrucciones para cablear una red local, construir una cocina solar, reparar un motor o seleccionar un proveedor de tornillos. Estos documentos son algo intermedio entre la mera documentación de programas y los artículos o libros muy técnicos y prácticos. Sin menoscabo de la libertad de lectura, copia, modificación y redistribución, el autor puede querer verter opiniones que no desea que se tergiversen, o al menos que esas tergiversaciones no se le atribuyan. O puede querer que se conserven párrafos, como agradecimientos. O que necesariamente se modifiquen otros, como el título. Aunque estas inquietudes pueden también manifestarse con los programas en sí mismos, no se han manifestado con tanta fuerza en el mundo del software libre como en el de la documentación libre. ibre como en el de la documentación libre.
Tamaño en bytes 0  +
Título Documentación de programas  +
Título de índice Capítulo 3. Sección 5. ''Documentación de programas''  +
Título sección Documentación de programas  +
Categorías Wikilibro Software libre  + , Secciones  +
Modification dateEsta propiedad es una propiedad especial en este wiki. 23 mayo 2012 15:27:03  +
ocultar propiedades que vinculen aquí 
Documentación de programas en Software libre + Página sección
 

 

Introduzca el nombre de la página para empezar a explorar.