Consejos para los nuevos colaboradores

¿Es un nuevo colaborador y no sabe qué hacer? ¿Quiere ayudar pero simplemente no sabe cómo empezar? Esta sección es para usted.

Herramientas básicas y flujo de trabajo

Si es un nuevo colaborador de Django, el :doc: tutorial /intro/contributing le dará una introducción a las herramientas y el flujo de trabajo.

Primeros pasos

Comience con estas tareas fáciles para descubrir el proceso de desarrollo de Django.

  • ** Firme el Acuerdo de Licencia del Colaborador**

    El código que escribe pertenece a usted o su jefe. Si su contribución es más de una o dos líneas de código, es necesario firmar el ALC. Consulte las ‘preguntas frecuentes sobre el Acuerdo de Licencia del Colaborador’ para una explicación más detallada.

  • Clasificación de tickets

    Si un ‘ticket no revisado’ informa de un bug, intente reproducirlo. Si puede reproducirlo y si parece válido, indique que usted corroboró el bug y acepta el ticket. Asegúrese de que el ticket se archive en el área del componente correcto. Considere escribir un parche que añada una prueba para el comportamiento del bug, incluso si usted no corrige el bug. Vea más en :ref: ‘Cómo puedo ayudar con la clasificación’ para más información.

  • ** Busque tickets aceptados y revise los parches para familiarizarse con la base de código y el proceso**

    Seleccione las banderas apropiadas si un parche necesita documentación o pruebas. Revise los cambios que realiza un parche, y esté pendiente de la sintaxis que no sea compatible con versiones anteriores, pero aún soportadas de Python. : doc: `Ejecute las pruebas </internals/contributing/writing-code/unit-tests> ` y asegúrese de que pasen. Siempre que sea posible y pertinente, pruébelas en una base de datos distinta de SQLite. ¡Deje comentarios y sugerencias!

  • ** Mantenga actualizados los parches anteriores**

    Con frecuencia la base de código variará entre el envio de un parche y el momento en que este es revisado. Asegúrese de que todavía se aplica de manera limpia y funciona como se espera. El simple hecho de actualizar un parche es tan útil como importante! Vea más sobre :doc: escribiendo código/presentando parches.

  • ** Escriba algo de documentación **

    Django’s documentation is great but it can always be improved. Did you find a typo? Do you think that something should be clarified? Go ahead and suggest a documentation patch! See also the guide on Writing documentation.

    Nota

    La página de informes contiene enlaces a muchas consultas Trac útiles, incluyendo varias que son útiles para clasificar tickets y revisar parches como se sugirió anteriormente.

Directrices

Como principiante en un proyecto grande, es fácil experimentar frustración. Estos son algunos consejos para hacer su trabajo en Django más útil y gratificante.

  • ** Elija un área temática que le interese, con la que esté familiarizado o sobre la que usted quiera aprender**

    Usted todavía no tiene que ser un experto en el área que desea trabajar; usted se convierte en un experto a través de sus constantes contribuciones al código.

  • Analice el contexto y el historial de los tickets

    Trac no es un absoluto; el contexto es tan importante como las palabras. Al leer Trac, es necesario tener en cuenta quién dice las cosas y cuándo se dicen. El apoyo que tuvo una idea hace dos años no significa necesariamente que todavía esté vigente. También es necesario prestar atención a quién no ha hablado, por ejemplo, si un miembro del equipo principal no ha participado recientemente en una discusión, entonces un ticket no podrá contar con el apoyo necesario para entrar en el tronco.

  • Empiece de a poco

    Es más fácil recibir comentarios y sugerencias sobre un problema pequeño que sobre uno grande. Vea los tickets presa fácil.

  • ** Si usted va a participar en una gran tarea, asegúrese primero de que su idea tenga apoyo**

    Esto significa lograr que alguien más confirme que un bug es real antes de que usted solucione el problema, y garantizar que el equipo principal apoye una funcionalidad propuesta antes de que usted la aplique.

  • ** ¡Sea valiente! ¡Deje un comentario!**

    A veces puede ser aterrador dar su opinión al mundo y decir “este ticket es correcto” o “este parche necesita trabajo”, pero es la única forma en la que el proyecto avanza. Las contribuciones de la gran comunidad Django, en última instancia, tienen un impacto mucho mayor que la del equipo principal. ¡No podemos hacerlo sin usted!

  • Peque de precavido al marcar cosas Listas para Registrar

    Si realmente no está seguro si un ticket está listo, no la marque como tal. En cambio deje un comentario, informándole a los demás lo que piensa. Si usted está casi seguro, pero no del todo, también podría intentar preguntar en el IRC para ver si alguien más puede confirmar sus sospechas.

  • Espere por retroalimentación y responda a los comentarios que reciba

    Concéntrese en uno o dos tickets, analícelos de principio a fin y repita el proceso. La táctica de la escopeta consistente en aceptar muchos tickets y dejar de lado algunos termina haciendo más daño que bien.

  • ** Sea riguroso **

    Cuando decimos ”:pep:` 8`, y debe tener documentación y pruebas ”, lo decimos en serio. Si el parche no tiene documentación y pruebas, debe haber una buena razón. Argumentos como “No pude encontrar ninguna prueba existente de esta funcionalidad” no tienen mucho peso, ya que si bien puede ser cierto, eso significa que tiene el trabajo extra importante de escribir las primeras pruebas para esa funcionalidad, no es que está exento del todo de escribir las mismas.

FAQ

  1. ¡El ticket que me interesa ha sido ignorado durante días/semanas/meses! ¿Qué puedo hacer para verlo confirmado?

    First off, it’s not personal. Django is entirely developed by volunteers (even the core team), and sometimes folks just don’t have time. The best thing to do is to send a gentle reminder to the django-developers mailing list asking for review on the ticket, or to bring it up in the #django-dev IRC channel.

  2. **Estoy seguro de que mi ticket es 100% perfecto, ¿Puedo marcarlo yo mismo como LPR? **

    Respuesta corta: No. Siempre es mejor contar con una segunda opinión al revisar los tickets. Si tiene problemas buscando esa persona, vea la pregunta 1, arriba.