diff options
author | Ralph Amissah <ralph.amissah@gmail.com> | 2021-11-27 21:54:49 -0500 |
---|---|---|
committer | Ralph Amissah <ralph.amissah@gmail.com> | 2021-11-27 21:54:49 -0500 |
commit | 78b1b83be0cf04b4cba707751b7ad4d97787fe37 (patch) | |
tree | 0260daae62c3c0c055b7ec73b274fa82b31b344f /markup/pod/live-manual/media/text/pl/project_contributing.ssi |
track document samples used
Diffstat (limited to 'markup/pod/live-manual/media/text/pl/project_contributing.ssi')
-rw-r--r-- | markup/pod/live-manual/media/text/pl/project_contributing.ssi | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/pl/project_contributing.ssi b/markup/pod/live-manual/media/text/pl/project_contributing.ssi new file mode 100644 index 0000000..e881cd5 --- /dev/null +++ b/markup/pod/live-manual/media/text/pl/project_contributing.ssi @@ -0,0 +1,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 |