{"id":22218320,"url":"https://github.com/coders-school/first-contribution","last_synced_at":"2025-07-05T19:37:08.394Z","repository":{"id":38262905,"uuid":"261411160","full_name":"coders-school/first-contribution","owner":"coders-school","description":"Learn how to contribute to open-source projects","archived":false,"fork":false,"pushed_at":"2023-12-30T12:16:30.000Z","size":787,"stargazers_count":1,"open_issues_count":0,"forks_count":78,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-05T19:37:06.766Z","etag":null,"topics":["contribution","open-source","tutorial"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coders-school.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-05T09:20:07.000Z","updated_at":"2022-06-08T05:44:02.000Z","dependencies_parsed_at":"2025-01-30T06:36:19.970Z","dependency_job_id":null,"html_url":"https://github.com/coders-school/first-contribution","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coders-school/first-contribution","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coders-school%2Ffirst-contribution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coders-school%2Ffirst-contribution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coders-school%2Ffirst-contribution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coders-school%2Ffirst-contribution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coders-school","download_url":"https://codeload.github.com/coders-school/first-contribution/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coders-school%2Ffirst-contribution/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263795380,"owners_count":23512668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contribution","open-source","tutorial"],"created_at":"2024-12-02T22:20:17.949Z","updated_at":"2025-07-05T19:37:08.369Z","avatar_url":"https://github.com/coders-school.png","language":null,"readme":"[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nOparte na [firstcontributions/first-contributions](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pl.md)\n\n# Pierwsze kontrybucje\n\nZawsze jest ciężko, kiedy robisz coś po raz pierwszy. Szczególnie gdy współpracujesz z innymi ludźmi, ponieważ popełnianie błędów nie jest niczym przyjemnym. Jednak właśnie na współpracy opiera się idea otwartego oprogramowania. Chcemy nauczyć w prosty sposób nowych programistów jak wgrać swoją pierwszą zmianę w obcym projekcie.\n\nCzytanie artykułów i oglądanie poradników może pomóc, ale czy jest coś lepszego niż spróbowanie czegoś samemu bez obaw, że się coś zepsuje? Ten projekt ma na celu dostarczyć nowicjuszom wskazówek i uprościć proces wgrania pierwszej zmiany. Pamiętaj: im bardziej się zrelaksujesz, tym lepiej się uczysz. Jeśli chcesz wgrać swoją pierwszą kontrybucję wykonaj kilka prostych kroków poniżej. Będzie fajnie, obiecujemy.\n\nOdróżnijmy najpierw Gita od GitHuba. Git to konsolowy program, za pomocą którego wersjonujemy kod, towrząc repozytoria. GitHub to platforma online, za pomocą której można wymieniać się kodem z innymi. GitHub ma jednak jeszcze wiele innych możliwości.\n\n## Co potrzebujesz?\n\n### Konto na GitHubie\n\nJeśli go nie masz, to je załóż.\n\n### Git\n\n#### Instalacja w Linuxie\n\n```bash\nsudo apt install git\n```\n\n#### Instalacja pod MacOS\n\n```bash\nbrew install git\n```\n\n#### Instalacja pod windows\n\n[Pobierz](https://git-scm.com/downloads) i zainstaluj\n\n\u003cimg align=\"right\" width=\"300\" src=\"assets/fork.png\" alt=\"fork this repository\" /\u003e\n\n## Utwórz fork repozytorium\n\nUtwórz fork tego repozytorium klikając przycisk \"Fork\" na górze tej strony.\nStworzysz tym samym kopie tego repozytorium na swoim koncie.\n\n## Sklonuj repozytorium\n\n\u003cimg align=\"right\" width=\"300\" src=\"assets/clone.png\" alt=\"clone this repository\" /\u003e\n\nTeraz sklonuj repozytorium na swój komputer. Kliknij na przycisk \"clone\" a później na ikonkę *skopiuj do schowka*.\n\nOtwórz konsolę i uruchom komendę git:\n\n```git\ngit clone \"wklej skopiowany adres\"\n```\n\nGdzie \"wklej skopiowany adres\" (bez cudzysłowia) to adres tego repozytorium. Zobacz poprzedni krok aby skopiować adres.\n\n\u003cimg align=\"right\" width=\"300\" src=\"assets/copy-to-clipboard.png\" alt=\"copy URL to clipboard\" /\u003e\n\nPrzykład:\n\n```git\ngit clone https://github.com/to-ty/first-contribution.git\n```\n\nW miejscu 'to-ty' wstaw swój login na githubie. W tym kroku ściągasz zawartość twojej kopii repozytorium first-contributions z githuba na swój komputer.\n\n## Stwórz gałąź\n\nWejdź w folder ze swoim repozytorium (jeżeli jeszcze tam nie jesteś):\n\n```bash\ncd first-contribution\n```\n\nTeraz utwórz nową gałąź wykonując polecenie `git checkout`:\n\n```git\ngit checkout -b \u003cadd-twoj-nick\u003e\n```\n\nPrzykład\n\n```git\ngit checkout -b add-kowalski\n```\n\n(Nazwa gałęzi nie musi zawierać słowa *add*, ale dobrze jest je dodać z racji tego, że celem tej gałęzi jest dodanie twojego imienia to listy.)\n\n## Wprowadź zmiany i wgraj je\n\nOtwórz plik `Contributors.md` w edytorze tekstu. Jest on zapisany w Markdown, lekkim języku znaczników. Tu masz \u003ca href=\"https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet\"\u003eściągawkę\u003c/a\u003e gdzie znajdziesz informację jak używać języka Markdown, ale wcale nie musisz go znać. Zobacz co już zawiera ten plik i wszystko będzie jasne.\n\nDodaj następującą linię na końcu `Contributors.md`\n\n```md\n- [Twój nick z Discorda](https://github.com/Twoja_nazwa_użytkownika)\n```\n\nPrzykład:\n\n```md\n- [John Doe](https://github.com/johndoe)\n```\n\nUpewnij się że nie ma spacji pomiędzy `](`. Zapisz plik i następnie go zamknij.\n\nJeżeli wejdziesz w folder ze swoim repozytorium i wykonasz komendę `git status`, zobaczysz, że są tam zmiany. Dodaj te zmiany do właśnie utworzonej gałęzi używając komendy `git add`:\n\n```git\n`git add Contributors.md`\n```\n\nJeśli teraz wpiszesz `git status` to dostaniesz informację, że plik Contributors.md został dodany do indexu. Teraz zapisz te zmiany wykonując komendę `git commit`:\n\n```git\ngit commit -m \"Add \u003ctwoj-nick\u003e to Contributors list\"\n```\n\nZastąp `\u003ctwoj-nick\u003e` swoim nickiem.\n\n### Konfiguracja użytkownika \n\nJeśli wyświetlają Ci się błędy, że nie masz ustawionej nazwy użytkownika i adresu email to je ustaw, zastępując odpowiednio `you@example.com` oraz `Your Name`.\n\n```git\ngit config --global user.email \"you@example.com\"\ngit config --global user.name \"Your Name\"\n```\n\nSpróbuj teraz wykonać commit. \n\n## Wyślij zmiany na GitHub\n\nWyślij swoje zmiany komendą `git push`:\n\n```git\ngit push origin \u003cadd-twoj-nick\u003e\n```\n\nZastąp `\u003cadd-twoj-nick\u003e` swoją nazwą gałęzi utworzoną wcześniej.\n\n## Wyślij swoje zmiany do zatwierdzenia\n\nW swoim repozytorium na GitHubie znajdziesz przycisk `Compare \u0026 pull request`. Kliknij go.\n\n\u003cimg style=\"float: right;\" src=\"assets/compare-and-pull.png\" alt=\"create a pull request\" /\u003e\n\nTeraz wyślij prośbę o scalenie.\n\n\u003cimg style=\"float: right;\" src=\"assets/submit-pull-request.png\" alt=\"submit pull request\" /\u003e\n\nNiedługo dodam proponowane przez ciebie zmiany do głównej gałęzi projektu. Dostaniesz mailowe powiadomienie, kiedy zmiany zostaną scalone.\n\n## Nie umiem w gita :(\n\nCoś Ci nie wychodzi lub nie wiesz jak zainstalować gita? To wszystko powyżej opisane można też wykonać bez użycia gita. GitHub zapewnia możliwość edytowania plików online. Wystarczy, że klikniesz na ikonę ołówka przy pliku.\n\n\u003cimg style=\"float: right;\" src=\"assets/github-edit.png\" alt=\"edit on GitHub\" /\u003e\n\nPo zapisaniu pliku (commit) wykonaj krok [Wyślij swoje zmiany do zatwierdzenia](#wyślij-swoje-zmiany-do-zatwierdzenia)\n\n## Co dalej?\n\nMożesz teraz zacząc uczestniczyć w innych projektach. Przygotowaliśmy listę projektów z prostymi zadaniami które będą dobre na początek. Sprawdź \u003ca href=\"https://roshanjossey.github.io/first-contributions/#project-list\" rel=\"nofollow\"\u003elistę projektów\u003c/a\u003e.\n\n### [Materiały dodatkowe](https://github.com/Roshanjossey/first-contributions/blob/master/additional-material/git_workflow_scenarios/additional-material.md)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoders-school%2Ffirst-contribution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoders-school%2Ffirst-contribution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoders-school%2Ffirst-contribution/lists"}