Trabaja desde una rama de prestación, no desde tu rama main¶
Antes de empezar a trabajar en su cambio, asegúrese que ha creado una rama. Por
defecto, cuando clonas tu bifurcación del repositorio, serás chequeado en tu
rama main. Ésta es una copia directa de la rama main de BeeWare.
Mientras puedas enviar un pull request desde tu rama principal, es
preferible que no lo hagas. Si envías un pull request que es casi correcto,
el miembro del equipo central que revise tu pull request podrá hacer los cambios
necesarios, en lugar de dar comentarios pidiendo un cambio menor. Sin embargo,
si envía su pull request desde su rama main, se impide a los revisores hacer
modificaciones.
Trabajar a partir de tu rama principal también dificulta las cosas para ti
después de completar tu primer pull request. Si quieres trabajar en un segundo
pull request, necesitarás tener una copia «limpia» de la rama principal del
proyecto upstream en la que basar tu segunda contribución; si has hecho tu
primera contribución desde tu rama principal, ya no tienes disponible esa
versión limpia.
En su lugar, deberías hacer tus cambios en una rama de prestaciones. Una rama
de prestaciones tiene un nombre simple para identificar el cambio que has hecho.
Por ejemplo, si estás corrigiendo un fallo que causa incidencias de compilación
en Windows 11, puedes crear una rama de prestaciones fix-win11-build. Si el
defecto está relacionado con una incidencia específica de la que se ha
informado, también es habitual hacer referencia al número de la incidencia en el
nombre de la rama (p.ej., fix-1234).
Para crear una rama de prestaciones fix-win11-build, ejecute:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build