On Mon, 2 Apr 2001, Luis Arocha -Data- wrote:
> Hola a todos,
>
> Como ver�is por el mensaje adjunto el grupo de control de calidad del
> proyecto Debian ha solicitado ayuda para realizar ciertas tareas:
> - Corregir errores.
> - Ayudar en la transici�n de /usr/doc --> /usr/share/doc
> - Crear p�ginas de manual.
>
> De las tres tareas �sta �ltima es la m�s f�cil y en la que CUALQUIERA
> que
> sepa lo que es un editor de textos puede ayudar. Se trata de crear
> p�ginas
> de manual para muchos programas que no la tienen.
>
> Realmente es muy f�cil.
Esta es una ocasi�n �nica para acometer algo quizas un poco ambicioso
pero muy necesario. Se trata de completar con ejemplos las p�ginas del
manual. Muchas veces dos l�neas de ejemplo ilustran m�s que una
descripci�n, y en Linux se echan de menos.
Evidentemente hay p�ginas que ni existen siquiera y ser�a prioritario
crearlas. Pero en el tema de los ejemplos podr�amos colaborar algo los que
no tenemos conocimientos de ingles. Para los que no sabemos suficiente
ingles tambi�n se podr�a crear paginas MAN en espa�ol quedando como
tarea pendiente para un traductor el pasarlo a idioma ingles. Yo pienso
que la productividad aumentar�a mucho por dar cabida a colaboraciones de
un mont�n de personas deseosas de ayudar y que no dominan lo suficiente
el ingles. En mi opini�n deben de ser unas cuantas. El cuyo de botella
ser�n siempre los traductores de espa�ol a ingles que est�n solicitad�simos
y haciendo montones de cosas, pero tampoco me parece tremendo que aparezca
una p�gina man en espa�ol o en otro idioma antes que en ingles.
Yo he realizado alguna p�gina man en espa�ol directamente con vi para
un programa que yo he desarrollado bajo GPL. (Me est�n ayudando a empaquetarlo
para Debian.) Realmente hacer una p�gina man es bastante sencillo. Yo aprend�
consultando como estaban realizadas algunas de ellas, y tambien animo a la
gente a participar en esto.
>
> �Qu� hay que hacer?
> - Escoger de la lista que propone Martin Michlmayr el programa
> que m�s te guste/que m�s odies/que m�s uses.
> - Bajarte los fuentes de unstable.
> - Mirar la salida prevista en caso de ejecutar el comando on la
> opci�n --help y, si fuera necesario, echar un vistazo al resto
> de las fuentes.
> - Escribir unos pocos p�rrafos en ingl�s con la descripci�n,
> opciones, valores de retorno, variables de entorno, etc�tera.
> - Formatear el texto en el formato de man. (En mi caso yo pienso
> usar el formato POD de perl, que es mucho m�s sencillo de usar,
> y despu�s con el comando pod2man... voil�)
> - Enviar el fichero resultante a Bug Tracking System.
>
> Y YA EST�. Ya habr�s contribuido al proyecto Debian.
Perdona mi tonta pregunta pero no veo en esto a ning�n coordinador.
Que pasa si todos cogemos la misma tarea ?
>
> Si alguien tiene inter�s estoy preparando una plantilla en formato POD
> para crear las p�ginas de manual con el comando pod2man y estoy a
> disposici�n de qui�n tenga problemas con alg�n paso.
Pues no conozco nada de eso. No me parece necesario pero siento curiosidad.
> Animo. Recordad que Debian est� realizada enteramente por voluntarios
Los desarrolladores oficiales de Debian deben tener cada vez m�s el apoyo
de simples voluntarios de la comunidad Linux, o de grupos m�s o menos
organizados al margen de Debian pero en buena sinton�a con ella como
sin duda lo es la espiral. Este tipo de iniciativas me parecen
estupendas y capaces de producir un modelo de desarrollo de software
libre que escalar�a probablemente mejor si se va descargando a Debian
de las tareas m�s pesadas para que puedan centrase en tareas de integrac�on
y en la parte digamos m�s pol�tica de la distribuci�n.
Un saludo
Antonio Castro
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
/\ /\ Ciberdroide Inform�tica (Tienda de Linux)
\\W// <<< http://www.ciberdroide.com >>>
_|0 0|_
+-oOOO--(___o___)--OOOo----------------------------------------------------+
| . . . . U U . . . . Antonio Castro Snurmacher [EMAIL PROTECTED] |
| . . . . . . . . . . |
+()()()----------()()()----------------------------------------------------+
| *** 1.700 sitios clasificados por temas sobre Linux en ***Donde_Linux*** |
| <<< http://www.ciberdroide.com/misc/donde/dondelinux.html >>> |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
