Precs de captació

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 Pautes de submissió (commit) si això us afecta.

Configuració d’una tirada

Donem per suposat que ja heu comprovat el repositori del manual del Blender en el vostre 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à un id_rsa de privada i un 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 precs de captació 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 del prec de captació hauria de ser usable com a missatge de submissió de git (vegeu les pautes per més detalls).

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

  • Si el prec de captació no s’aprova, s’espera que l’autora faci una altra iteració.

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

  • S’espera que les escriptores responguin als precs de captació 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 del prec de captació. Exemple:

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

  • Expediu un prec de captació dins un cap solt (sense deixar enrere cap ramificació). Exemple:

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