cvs: peardoc /es/chapters contributing.xml
| From: | Miguel Angel Molina aka jurbo | 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
-->