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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
:B~ Wnoszenie wkładu do tego projektu
1~contributing-to-project Wnoszenie wkładu do tego projektu
Wnosząc swój wkład należy jasno określić posiadacza jego praw autorskich i
zawrzeć wszelkie stosowane oświadczenie licencjonowania. Należy pamiętać, że
aby zmiany były zaakceptowane, wkład musi być licencjonowany na tej samej
licencji co reszta dokumentów, a mianowicie, GPL w wersji 3 lub nowszej.
Wkład do projektu, taki jak tłumaczenia i poprawki, są bardzo mile
widziane. Każdy może bezpośrednio zaangażować się w repozytoriach, jednak
prosimy wysłać większe zmiany do listy mailingowej, aby omówić je w
pierwszej kolejności. Patrz rozdział {kontakt}#contact aby uzyskać więcej
informacji.
${projekt} używa Git jako systemu kontroli wersji i zarządzania kodem
źródłowym. Jak wyjaśniono w {repozytorium Git}#git-repositories są dwie
główne gałęzie rozwoju: *{debian}* i *{debian-next}*. Każdy może wprowadzić
zmiany do gałęzi *{debian-next}* w repozytoriach ive-boot, live-build,
live-config, live-images, live-manual i live-tools.
Jednakże istnieją pewne restrykcje. Serwer odrzuci:
_* Non fast-forward pushes.
_* Zmiany wymagające scalenia.
_* Dodawanie lub usuwanie tagów lub gałęzi rozwojowych.
Nawet jeżeli wszystkie zmiany mogą być później zweryfikowane, prosimy abyś
używał zdrowego rozsądku i tworzył dobre zmiany opisane dobrym komentarzem.
_* Pisz komentarze do zmian, które składają się z pełnych, sensownych zdań w
języku angielskim, począwszy od dużej litery, a kończących się
kropką. Zwykle te komentarze zaczynają się od
"Fixing/Adding/Removing/Correcting/Translating/...".
("Naprawianie/Dodawanie/Usuwanie/Korygowanie/Tłumaczenie/ itd. ... ".)
_* Pisz dobre komenarze do zmian. Pierwsza linia musi być dokładne
podsumowanie treści popełnić, która zostanie uwzględniona w liście zmian
(ang. changelog). Jeśli musisz zrobić kilka wyjaśnień, napisz je niżej
pozostawiając pusty wiersz po pierwszej lini, a następnie kolejny pusty
wiersz po każdym akapicie. Linie każdego akapitu nie powinny przekraczać 80
znaków.
_ * Wysyłaj zmiany osobno. To znaczy; nie mieszaj niepowiązanych ze sobą
rzeczy w tej samej zmianie. Dodać osobną zmianę dla każdej rzeczy, którą
zmieniasz.
2~ Wprowadzanie zmian
W celu wysłania zmian do repozytoriów, należy wykonać następującą
procedurę. Tutaj używamy live-manual jako przykładu, więc zastąp go nazwą
repozytorium, z którym chcesz pracować. Aby uzyskać szczegółowe informacje
na temat edycji podręcznika live-manual zobacz: {Współtworzenie tego
dokumentu}#how-to-contribute.
_* Pobierz publiczny klucz do wprowadzania zmian:
code{
$ mkdir -p ~/.ssh/keys
$ wget http://live-systems.org/other/keys/git@live-systems.org -O ~/.ssh/keys/git@live-systems.org
$ wget http://live-systems.org/other/keys/git@live-systems.org.pub -O ~/.ssh/keys/git@live-systems.org.pub
$ chmod 0600 ~/.ssh/keys/git@live-systems.org*
}code
_* Dodaj następującą sekcję do twojej konfiguracji klienta openssh:
code{
$ cat >> ~/.ssh/config << EOF
Host live-systems.org
Hostname live-systems.org
User git
IdentitiesOnly yes
IdentityFile ~/.ssh/keys/git@live-systems.org
EOF
}code
_* Sprawdź i sklonuj kopię live-manual przez through ssh:
code{
$ git clone git@live-systems.org:/live-manual.git
$ cd live-manual && git checkout debian-next
}code
_* Upewnij się, że masz ustawionego autora i adres email w konfiguracji Git:
code{
$ git config user.name "John Doe"
$ git config user.email john@example.org
}code
*{Ważne:}* Pamiętaj, że powinno się wprowadzać wszelkie zmiany wyłącznie w gałęzi *{debian-next}*.
_* Wprowadź zmiany. W tym przykładzie będzie najpierw napisać nowy dział
dotyczący stosowania plastrów, a następnie przygotować się do popełnienia
dodawanie plików i pisanie popełnienia wiadomość tak:
code{
$ git commit -a -m "Adding a section on applying patches."
}code
_* Wyślij poprawki na serwer:
code{
$ git push
}code
|
