Demandes de succió (pull requests)

Aquesta pàgina descriu les eines utilitzades per a contribucions i revisions de codi.

Les revisions són una mesura clau per assegurar que els canvis són de bona qualitat. Ajuden a prevenir pífies, incoherències de disseny o problemes potencials de manteniment. I saber que se us revisarà el treball en general assegura que us manteniu al cas.

Nota

Escriptores a qui s’ha donat accés de submissió (commit) al repositori principal sense necessitat de bifurcar el repositori.

Vegeu :doc:`/contribute/guides/commit_guide`si això us afecta.

Configuració d’una tirada

Assumeix que ja teniu comprovat el repositori manual del Blender de l’ordinador, seguint les instruccions d’instal·lació.

Bifurcació

  1. Aneu al repositori del Blender i feu clic al botó Fork.

  2. Confirmeu la bifurcació amb la configuració per defecte.

  3. Ara haureu d’afegir la vostra bifurcació (fork) personal com a remot al vostre repositori git local. Feu clic a SSH per a veure l’URL correcte i després afegiu-lo així:

    git remote add me [email protected]:<USERNAME>/blender-manual.git

Nota

Per empènyer envers el repositori de bifurcació, us cal una clau SSH. Si encara no teniu el document ~/.ssh/id_rsa.pub, hi ha una ordre senzilla per generar aquestes claus que funciona amb Linux, macOS i a Git Bash a Windows:

ssh-keygen

Aquesta ordre generarà una id_rsa de privada i una id_rsa.pub de clau pública a ~/.ssh. La clau privada no l’heu de mostrar ni enviar a ningú per evitar de deixar el vostre compte al descobert, però la clau pública és segur compartir-la.

El contingut de ~/.ssh/id_rsa.pub es pot copiar i enganxar a la paràmetres de comptes de projects.blender.org, després de fer clic a «Afegir clau» (Add Key). Per a la clau SSH serveix qualsevol mena de nom.

Procedimentació

La procedimentació per treballar amb demandes de succió (pull requests) es pot trobar a Documentació de desenvolupadores de Blender.

Nota, algun text de la directriu de més amunt se centra en el repositori principal de Blender; en tot cas, la procedimentació és la mateixa per a tots els projectes de Blender.

Pautes per als revisors

  • El text de la demanda de succió (pull request) hauria de ser usable com a missatge de submissió de git (vegeu les pautes per a més detalls).

  • Sigueu explícits quan s’han d’abordar alguns canvis abans de sotmetre, sense que calgui una iteració de revisió.

  • Si la demanda de succió no s’aprova, s’espera que l’autora faci una altra iteració.

  • Si el canvi requereix d’un acord previ sobre la tasca de disseny, poseu la demanda de succió en espera afegint-hi un prefix WIP: al títol, i indicant que l’autor considera que la demanda de succió no està llesta per a la fusió. No s’espera cap revisió tret que l’autor ho demani específicament.

  • S’espera que les escriptores responguin a les demandes de succió en 3 dies laborables.

  • Afegir mòduls/projectes pertinents a les etiquetes.

  • Afavoriu la revisió de nous escrits; és una bona manera d’aprendre i és important per al creixement del projecte.

Truquets

  • Per a obtenir el document pedaç, afegiu .patch al final de l’URL de la demanda de succió. Exemple:

    https://projects.blender.org/blender/blender-manual/pulls/104892.patch

  • Expediu una demanda de succió dins un cap solt (sense deixar enrere una branca). Exemple:

    git fetch -q origin +refs/pull/104892/head: ; git checkout -qf FETCH_HEAD