1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
<p>
En principi tots els projectes que veureu a la meva
<a href="https://git.mssola.com">instància de Git</a> o al
meu <a href="https://github.com/mssola">perfil de Github</a> són personals.
Amb això vull dir que honestament no espero cap contribució, però tot i així
sempre s'agraeix l'ajuda :-) Si voleu informar d'algun error o suggerir alguna
millora, <a href="mailto:mssola@mssola.com" title="mssola@mssola.com">em podeu
enviar un correu electrònic</a>. Sinó, si realment voleu contribuir amb
canvis, prefereixo que m'envieu pedaços per correu electrònic. És a dir:
<p>
<ul>
<li>
Utilitzeu les comandes natives de Git
(p.e. <code>commit</code>, <code>rebase</code>, et al) per tal d'obtenir un
llistat de commits que voldríeu que revisés.
</li>
<li>
Escriviu <a href="https://chris.beams.io/posts/git-commit/" title="Entrada
sobre com escriure bons missatges de Git">bons missatges als
commits</a>. Encara millor si estan en l'estil
del <a href="https://docs.kernel.org/process/submitting-patches.html"
title="Linux kernel">nucli Linux</a>.
</li>
<li>
Utilitzeu l'opció <code>--cover-letter</code>
de <a href="https://git-scm.com/docs/git-format-patch" title="git
format-patch">git format-patch</a> si esteu enviant diversos commits, i
expliqueu allà perquè hauria de revisar els vostres canvis.
</li>
<li>
Envieu-ho tot amb <a href="https://git-scm.com/docs/git-send-email"
title="git send-email">git send-email</a> i miraré de respondre a les
propostes de canvi.
</li>
</ul>
<p>
Si sou suficientment <em>frikis</em> com per haver fet un fork d'algun
projecte meu, aleshores també podríeu utilitzar la comanda nativa de
git <a href="https://git-scm.com/docs/git-request-pull"
title="git-request-pull manual">request-pull</a>, encara que prefereixo el
mètode que suara he llistat amb <code>git-send-email</code>.
</p>
<p>
Havent dit això, si tot plegat només us genera dubtes i creieu que va més
enllà de l'experiència que teniu amb el desenvolupament de programari, podeu
considerar com a últim recurs enviar-me un <a href="https://github.com/mssola"
title="El meu perfil de Github">PR a Github</a>. Per a tots els projectes que
tinc a la meva
<a href="https://git.mssola.com">instància de Git</a>, miro de tenir un mirror
a Github que estigui raonablement actualitzat (no prometo res). Igualment, no
fusionaria res per allà i ho faria a mà. Això inclou que potser faig canvis en
el missatge si s'escau.
</p>
<p>
Per acabar, m'afegeixo
al <a href="https://docs.kernel.org/process/submitting-patches.html#developer-s-certificate-of-origin-1-1"
title="Descripció del Certificat d'Origen del Desenvolupador 1.1">Certificat
d'Origen del Desenvolupador 1.1</a>. Per tant, per a cada commit necessito
el <code>Signed-off-by</code> si voleu que agafi els vostres canvis. A més,
si la vostra contribució ha estat feta en qualsevol part del procés amb
l'ajuda d'un model de llenguatge, també m'agradaria saber-ho. Agraeixo
l'honestedat i faria que el procés de revisió l'encarés d'una altra manera.
</p>
|
