cvs: peardoc /es/chapters contributing.xml

From: Date: Thu, 15 Apr 2004 11:04:15 +0000
Subject: cvs: peardoc /es/chapters contributing.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3486@lists.php.net to get a copy of this message
jurbo Thu Apr 15 07:04:15 2004 EDT Added files: /peardoc/es/chapters contributing.xml Log: por revisar una oración http://cvs.php.net/co.php/peardoc/es/chapters/contributing.xml?r=1.1&p=1 Index: peardoc/es/chapters/contributing.xml +++ peardoc/es/chapters/contributing.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <chapter id="contributing"> <docinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> </author> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2003-03-21</date> </docinfo> <title>Contribuyendo</title> <simpara> Este capítulo describe las diferentes formas en las que alguien puede contribuir con PEAR. </simpara> <sect1 id="contributing.introduction"> <title>Introducción</title> <simpara> PEAR es un proyecto de código abierto, que significa que todo el mundo puede ayudar a mejorarlo. Mejorarlo no tiene por qué significar escribir código. Puede significar reportar errores, darnos opiniones, enviarnos peticiones de características o incluso darnos apoyo económico. </simpara> </sect1> <sect1 id="contributing.newpackage"> <title>Escribiendo nuevos paquetes</title> <para> Se pueden encontrar explicaciones sobre cómo publicar nuevos paquetes en la <link linkend="guide-developers">Guía para Desarrolladores</link>. </para> </sect1> <sect1 id="contributing.patches"> <title>Enviar Parches</title> <para> Si modificas algún paquete para aumentar sus funciones o para reparar algún error, debes contribuir con tus cambios a la comunidad (algunas licencias obligan a hacerlo, y en general se considera inmoral no hacerlo). </para> <para> Antes de crear el parche, primero debes obtener los últimos fuentes del servidor CVS del paquete que quieras parchear ejecutando los siguientes comandos (el paquete del ejemplo es Foo_Bar): <screen> <command>cvs -d:pserver:cvsread@cvs.php.net:/repository login</command> password is "phpfi" <command> cvs -z3 -d:pserver:cvsread@cvs.php.net:/repository co pear/Foo_Bar </command> </screen> Ahora que tienes la última versión del código fuente, puedes editar los ficheros o el fichero relevantes. Asegúrate de que tu parche es totalmente compatible con los &link.coding-standards;. </para> <para> Una vez que hayas terminado de añadir o cambiar código, PRUEBALO: No aceptaremos código que no haya sido cuidadosamente probado. Cuando estés totalmente seguro de que tu nuevo código no genera errores, crea un único fichero diff ejecutando: <screen> <command>cd pear/Foo_Bar</command> <command>cvs diff -u >Foo_Bar.diff</command> </screen> El fichero .diff resultante contiene tu parche. Este fichero nos hace más fácil el ver qué cambios se han realizado. </para> <para> El siguiente paso es enviarnos el parche. Envía un correo electrónico a &email.pear.dev; y agrega como Cc a los mantenedores del paquete. El asunto del correo debe estar precedido por la palabra '[Patch]' para aclarar que estás enviando un parche. Incluye también una explicación de lo que hace el parche. No olvides adjuntar el fichero .diff a tu correo. Los mantenedores del paquete suelen aparecer en la cabecera de cada fichero del código fuente, además sus direcciónes de correo electrónico están disponibles en la página de información del paquete en &url.pear;. </para> <note> <para> Si usas Outlook o Outlook Express, por favor cambia la extensión del fichero .diff a .txt, porque la detección de los tipos MIME del Outlook depende de la extensión de los ficheros, y el software gestor de nuestra lista de correo no aceptará ningún correo cuyo tipo MIME no sea <literal>text/plain</literal> (texto plano). </para> </note> <note> <para> Si tu parche no ofrece compatibilidad hacia atrás,**** . Por lo tanto, siempre debes intentar solucionar un error de manera que no cambie gravemente la API pública. Pero si no hay forma alguna de mantener compatibilidad con versiones anteriores y/o si tu parche contiene **groundbracking**, sería magnífico que hicieras cambios a la API. If your patch does break backwards compatibility, **[the chances are fairly good that the maintainers won't be happy about it]**. Thus you should always try to fix a bug in a way that does not seriously change the public API. But if there is absolutely no way to keep backwards compatibility and/or if your patch contains a ***groundbraking*** improvement, even API changes are fine. </para> </note> </sect1> <sect1 id="contributing.bugs"> <title>Reportando Errores</title> <para> Si crees que has encontrado un error en un paquete de PEAR, por favor asegurate de que usas la última versión de dicho paquete y de que tu sistema cumple los requisitos del paquete. </para> <para> Si el error aun aparece en la última versión del paquete, no dudes en reportarnos el error. La manera más fácil es hacer click en el link <quote>Package Bugs</quote> (Errores del Paquete) en la página de información del paquete que crees que tiene un error, en la <ulink url="&url.pear;">Web de PEAR</ulink>. Esto te remitirá a una lista de los errores existentes del paquete. ¡Por favor, asegurate de que el error no haya sido reportado ya!. Si no consigues encontrar el error en la lista, haz click sobre <quote>Report a new bug</quote> (Reportar un nuevo Error) para rellenar el formulario para enviarnos errores. </para> <para> Puedes encontrar más información e indicaciones sobre como se deben reportar errores en <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink> </para> <para> Si ya has solucionado un error que has encontrado en un paquete, por favor leete <link linkend="contributing.patches">esto</link> </para> </sect1> <sect1 id="contributing.wishlist"> <title>Listas de Deseos</title> <para> Algunos de los desarrolladores de PEAR tienen "Wishlists" que son listas de cosas que les gustaría tener, en Amazon y sitios por el estilo. Si tú quieres agradecer el trabajo de algún desarrollador, sientete libre de comprarle algo de su "lista de deseos". Para saber si un desarrollador tiene una de estas listas, ve al <ulink url="&url.pear.account;">navegador de cuentas</ulink>, busca los detalles del desarrollador y allí encontrarás la lista, si la tiene. Comprar algo de las listas de deseos de la gente ayuda a acelerar el tiempo que tardan los molestos errores en ser solucionados ;-) </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->

« previous php.pear.doc (#3486) next »