Se on vaikeaa. Ensimmäiset kerrat ovat aina vaikeita. Etenkin tehdessä yhteistyötä, virheiden teko ei ole ollenkaan mukavaa. Me halusimme yksinkertaistaa tavan jolla avoimen lähdekoodin kontribuoijat oppivat sekä kontribuoivat ensimmäistä kertaa.
Artikkeleiden lukeminen sekä tutoriaalien katsominen voi auttaa, mutta mikä onkaan parempaa kuin käytännön harjoite harjoitusympäristössä? Tämä projekti tähtää avun tarjoamiseen sekä aloittelijoiden ensimmäisen kontribuution yksinkertaistamiseen. Jos olet aikeissa kontribuoida ensimmäistä kertaa, seuraa alla olevia ohjeita.
Jos et osaa käyttää komentoriviä sulavasti, täältä löytyy tutoriaaleja GUI-työkalujen käyttöön.
Jos sinulla ei ole git asennettuna koneellesi, asenna se.
Forkkaa tämä repositorio klikkaamalla yläkulmassa näkyvää painiketta "Fork". Tämä luo kopion tästä repositoriosta käyttäjällesi.
Seuraavaksi kloonaa juuri forkkaamasi repositorio koneellesi. Mene GitHub käyttäjäsivuillesi, avaa forkkaamasi repositorio sekä klikkaa "Clone or download"-painiketta jonka jälkeen kopioi osoite painamalla "Copy to clipboard"-ikonia.
Avaa komentorivi ja syötä seuraava git-komento:
git clone "Juuri kopioimasi URL"
"Juuri kopioimasi URL"-tekstin sijasta (ilman lainausmerkkejä) pastea repositorion URL äskeisestä vaiheesta.
Esimerkiksi:
git clone https://github.com/nimesi/first-contributions.git
Kirjoita GitHub-käyttäjänimesi 'nimesi' teksin sijaan. Tämä komento kopioi sisällön GitHubisi first contributions-repositorion koneellesi.
Mene repositoriosi kansioon koneellasi (ellet jo ole siellä).
cd first-contributions
Seuraavaksi luo branch komennolla git checkout
:
git checkout -b <lisaa-sinun-branchin-nimi>
Esimerkiksi:
git checkout -b add-matti-meikalainen
(Branchin nimeen ei välttämättä tarvitse sisällyttää sanaa add, mutta tässä se käy järkeen sillä tämän branchin tarkoitus on lisätä nimesi listaan.)
Seuraavaksi avaa Contributors.md
tiedosto tekstieditorissa ja lisää nimesi tiedostoon. Älä lisää sitä tiedoston alkuun taikka loppuun vaan keskelle. Seuraaksi tallenna tiedosto.
Jos menet projektin kansioon ja syötät komennon git status
, näet muutokset.
Lisää nuo muutokset branchiin git add
komennolla:
git add Contributors.md
Seuraavaksi committoi muutokset git commit
komennolla:
git commit -m "Add <sinun-nimesi> to Contributors list"
Korvaamalla <sinun-nimesi>
nimelläsi.
Pushaa muutoksesi komennolla git push
:
git push origin <lisaa-branchisi-nimi>
Korvaamalla <lisaa-branchisi-nimi>
nimellä jonka annoit branchillesi aikaisemmin.
Jos menet repositorioosi GitHubissa, näet Compare & pull request
painikkeen. Paina tuota painiketta.
Seuraavaksi suorita pull request.
Seuraavaksi mergeän muutoksesi tämän projektin master-branchiin. Tulet saamaan ilmoituksen sähköpostiisi kun muutokset ovat mergetty.
Onneksi olkoon! Olet juuri suorittanut tavanomaisen Fork -> Clone -> Edit -> Pull Request -työnkulun joka tulee vastaasi usein kontribuoijana!
Juhlista kontribuutiotasi ja jaa se ystävillesi ja followereillesi menemällä Web Appiin.
Voit liittyä Slack tiimiimme jos sinulla on kysyttävää. Liity Slack tiimiin.
Jos haluaisit kontribuoida muihin projekteihin, me olemme koonneet listan yksinkertaisista ensimmäisistä issueista työskenneltäväksesi. Lista löytyy Web-Appistamme.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |