Pautas de envío de modificaciones¶
El acceso para enviar modificaciones directamente estará limitado a personas con acceso a la realización de modificaciones al repositorio. Una vez que se proporcione acceso a la realización de modificaciones, se podrá comenzar a enviarlos directamente en lugar de tener que crear archivos de parches.
Será posible realizar modificaciones desde el cliente de Git local o mediante la herramienta de línea de comandos de Git. El siguiente comando creará una modificación y lo enviará al repositorio central:
git commit -m "This is what I did"
git push
Cuando se omita -m "mensaje"
, se solicitará escribir el mensaje en un editor de texto.
Truco
Asegurarse de estar siempre en la última revisión antes de confirmar. Es posible que no sea posible confirmar directamente si hubiera cambios en conflicto en la última revisión.
Para evitar esto, actualizar el repositorio local antes de confirmar (ejecutar make update
).
Ver también
Ver también
Ver rama de lanzamiento para obtener documentación sobre cómo realizar modificaciones a una rama de lanzamiento específica y cómo fusionar las mismas en la rama de desarrollo.
Escritura de un buen mensaje de envío de una modificación¶
Al realizar modificaciones en el manual que se relacionen directamente con alguna modificación específica de Blender, será útil hacer que el título de la modificación sea el mismo que el de la modificación realizada a Blender. Se solicitará que se incluya el código de comprobación (hash) de la modificación realizada al código fuente de Blender.
Por ejemplo, la modificación rBM8473 incluye una descripción indicando los cambios realizados junto con el código de comprobación rBa71d2b260170
. El código de comprobación podrá ser extraído de la URL proporcionada en la tarea de documentación para una versión específica futura.
Otras modificaciones más generales no tendrán por qué seguir la política anterior; sin embargo, será importante que su descripción sea clara sobre qué cambios se realizaron y la razón de los mismos. Podrá ser útil agregar un prefijo al título de la modificación, tales como Cleanup:
o Fix:
, cuando se realizaran limpiezas o correcciones generales, respectivamente.
Escribir buenos mensajes al enviar modificaciones ayudará a los administradores a realizar un seguimiento de los cambios realizados y garantizará que todas las funciones nuevas estén debidamente documentadas.