|
|
¡PARTICIPA!
Proyectos TLDP-ES
Servicios TLDP-ES
Otros proyectos replicados en TLDP-ES
Otros proyectos importantes
Más documentación (inglés)
De Interés
Servicios de Noticias
Sobre TLDP-ES
|
TLDP-ES - Manuales para Cursos de GNU/Linux
Objetivos y características del proyecto Este proyecto consiste en la realización de una serie de manuales aptos para el dictado de clases sobre el sistema GNU/Linux. ¿Qué diferencias tienen estos manuales a los que ya existen?, el ser diseñados específicamente para el dictado de clases significa que no sólo se han de desarrollar los contenidos de cada manual, sino también ejercitación en cada tema, y otra documentación para asistir al docente (ej: estrategias de interacción con los alumnos, para dinamizar la clase, guía de temas a dar por clase, ejercitación práctica, etc.) En un principio el proyecto tenía como objetivo la generación de 5 manuales para diferentes niveles de cursos, pero pronto nos dimos cuenta que los requerimientos de cursos varían muchísimo de caso en caso, es por eso que ideamos el sistema de porciones, que nos permite personalizar los cursos. En la actualidad estamos migrando todo el material a DocBook, un formato de documentación estructurada que nos hará la vida mas fácil a la hora de generar nueva documentación. Esto supone una gran cantidad de trabajo, y cuanto mas ayuda tengamos, tanto mejor! El sistema de porciones Luego de haber logrado casi terminar el primer curso (básico) y empezado el segundo, nos encontramos con el problema de que necesitábamos armar cursos de distintas características a los que ya estaban hechos. Éstos variaban en tamaño y nivel de los distintos temas y la solución inmediata que veíamos era la de copiar y pegar parte del material generado por el proyecto en los nuevos cursos. Obviamente, esto no era una buena solución, ya que se generaba duplicación de material, y por lo tanto, desactualización de los cursos nuevos ya que los agregados y correcciones se hacían en los cursos originales. Además de esto, el copiar y pegar pedazos de texto era algo totalmente incómodo y tedioso. De esta experiencia, nació la idea del sistema de porciones, ¿porciones de qué? de documentación. Podemos pensar en cada porción como un componente de documentación, que se puede combinar con otras porciones para generar un documento completo. Este concepto los programadores ya lo conocemos, los componentes de software han sido desarrollados con la misma idea. Lo bueno de tener el material componentizado es que los problemas anteriormente mencionados se solucionan: las porciones se mantienen en un repositorio centralizado, de tal manera que las correcciones y agregados puedan ser aprovechados por todos, y además la generación de cursos personalizados es increiblemente fácil de hacer, tanto que estamos desarrollando un sistema en web que lo hace. Básicamente las porciones son archivos conteniendo un tema específico, por ejemplo «Uso y configuración de pine». Las porciones son combinadas mediante un archivo que llamados esqueleto, que incluirá cada archivo de porción para que al procesarlo, el documento resultante sea el conjunto de porciones seleccionadas, en el orden requerido. Las porciones actualmente son escritas en DocBook, pero no conforman por si mismas un documento completo. De todas maneras estamos desarrollando utilidades que nos permiten validar estos documentos parciales para poder trabajar cómodamente. El sistema de porciones nos trae soluciones, pero también algunos problemas inherentes a esta nueva forma de generar documentación: debemos resolver las referencias cruzadas entre porciones, por ejemplo. Esto lo iremos solucionando a medida que terminemos la migración de las porciones existentes en LaTeX (¡que son muchas!), si estás dispuesto a ayudar, el no saber no es un limitante, tenemos una lista de correo donde te podremos guiar. Reporte de tareas A medida que el grupo de trabajo crece, se hace muy necesaria la formalización de algún tipo de sistema organizativo de manera de no hacer perder el escaso tiempo libre que los colaboradores invertimos en el proyecto. Esta problemática es común a cualquier grupo de trabajo y es por eso que tenemos a disposición un sistema de reportes de tareas, llamado Bugzilla. Este sistema originalmente fue desarrollado por el equipo de Mozilla, para llevar el control de los errores de este fabuloso navegador de páginas web, y los amigos de HispaLinux lo han instalado para que nos organicemos mejor. Básicamente Bugzilla consiste en un sistema de administración de reportes y productos. Los tipos de reportes varían entre: errores a corregir, tareas de migración, redacción de documentación, etc. Dichos reportes se asignan a un producto específico, como por ejemplo «Página Web», «Sistema de facturación», «Documentación», etc. Nuestro proyecto tiene asignado un producto en Bugzilla, llamado doc-proyecto-cursos. Todas las tareas pendientes las registramos en Bugzilla de tal manera que sepamos en cada momento el estado del proyecto, donde hace falta trabajar, y donde se están retrasando los trabajos asignados, en fin, esta herramienta nos facilita enormemente la organización interna. Para ampliar mas sobre Bugzilla, puedes leer aquí. Tareas pendientes Si estás con ganas y tiempo de colaborar en este proyecto, ¡no hay excusas para no hacerlo!, todo lo pendiente lo puedes ver en nuestra sección del Bugzilla. Si necesitas buscar sobre los reportes en el Bugzilla, lo puedes hacer aquí. ¿Cómo empezar a colaborar? Además de Bugzilla, utilizamos otras dos herramientas muy valiosas para nuestro trabajo: una lista de correo y un repositorio CVS. Si no conoces que es un CVS, te recomiendo que leas esta rápida introducción. La lista de correo la utilizamos para todo lo que sea organización interna del grupo, es imprescindible que te suscribas a ella para ponerte en contacto con nosotros. También puedes leer los mensajes anteriores para irte enterando cómo es nuestra mecánica de trabajo. El CVS es la herramienta necesaria para acceder a los archivos del proyecto. Cada colaborador requiere de una cuenta personal en el servidor para agregar y/o modificar el contenido de los archivos, pero cualquiera puede descargar los archivos anónimamente, esto se explica aquí. Puedes ver la actividad del proyecto en el CVS desde aquí. Si necesitas una cuenta personal en el CVS, sólo tienes que pedirla en el Bugzilla. Hay que estar registrado en el Bugzilla antes de poder generar reportes, pero no te preocupes que no es un proceso difícil, lo puedes hacer aquí. Cuando pidas la cuenta en el CVS te pedirán una contraseña, que debes generar con el siguiente comando desde GNU/Linux: perl -e 'printf("%s\n",crypt("TU CLAVE","FA"));'Este comando generará una cadena de texto con tu clave cifrada, debe enviarle esa cadena al administrador del CVS. Para una referencia mucho más completa sobre cómo colaborar con TLDP-ES, puedes leer la sección «Cómo participar en TLDP-ES». Si deseas aportar material al proyecto, no es
imprescindible que poseas cuenta en el servidor, sólo
ponte en contacto con alguno de los coordinadores del
proyecto: Descarga de cursos «pre-fabricados» En cuanto terminemos con la migración de las porciones al nuevo formato, presentaremos aquí una serie de cursos estándares para que puedas descargar. ¿Cómo generar mi propio curso? Como parte del proyecto, y aprovechando la flexibilidad del sistema de porciones, estamos desarrollando un sistema en web para la generación de cursos personalizados. Por ahora la idea es elegir los temas y porciones que el curso incluirá, y el sistema genera automáticamente el archivo esqueleto correspondiente, que luego se utilizará junto con los archivos obtenidos del CVS para generar el curso en formato PS o PDF. Actualmente no tenemos el sistema totalmente depurado y probado. Además hemos desarrollado una herramienta gráfica para el armado de cursos, que está en un estado usable, y se incluye en el repositorio CVS del proyecto.
|
Última modificación:
19 de junio de 2007
Mantenida por: Lucas Di Pentima |
Copyright © 1999-2002 Hispalinux. Los documentos publicados en estas
páginas son propiedad de sus respectivos autores, y su
distribución o reproducción en cualquier forma y por
cualquier medio está restringida a los
términos de la licencia GNU GPL
salvo indicación expresa que afirme lo contrario.
Esta web es posible gracias a los servicios de alojamiento de Alójate. |