freeCodeCamp/docs/i18n/Finnish/how-to-open-a-pull-request.md

Kuinka avata Pull-pyyntö (PR)

Pull pyyntö mahdollistaa sen, että voit lähettää muutoksia haarukastasi GitHubissa freeCodeCamp.orgin päärepoon. Kun olet tehnyt muutoksia koodiin, tai koodaus haasteita, sinun tulee noudattaa näitä ohjeita lähettää PR.

Valmistele hyvä PR-otsikko

Suosittelemme käyttämään perinteistä otsikkoa ja viestejä commitit ja vedä pyyntö. Yleissopimuksen muoto on seuraava:

<type>([valinnainen soveltamisala(t)]): <description>

Esimerkiksi:

fix(learn): testit tehdä...kun silmukka haaste

Kun avaat Pull Request(PR), voit käyttää alla olevaa määrittääksesi tyypin, laajuuden (valinnainen) ja kuvauksen.

Tyyppi:

Tyyppi	Milloin valita
korjaa	Muutettu tai päivitetty/parannettu toiminnallisuus, testit, oppitunti ja niin edelleen.
tappio	Vain jos lisäät uusia toimintoja, testejä jne.
urakka	Muutokset, jotka eivät liity oppituntien koodiin, testeihin tai sanamuotoon.
docs	Muutokset /docs -hakemistoon tai rahoitukseen liittyviin ohjeisiin jne.

Laajuus:

Voit valita laajuuden tästä tunnisteiden luettelosta.

Kuvaus:

Pidä se lyhyt (alle 30 merkkiä) ja yksinkertainen, voit lisätä lisää tietoa PR-kuvauslaatikkoon ja kommentteihin.

Esimerkkejä PR-ohjelmien hyvistä nimikkeistä olisivat seuraavat:

• fix(a11y): parempi hakupalkin kontrasti
• feat: lisää testejä html- ja css haasteisiin
• fix(api,client): estää CORS-virheitä lomakkeen toimittamisessa
• docs(i18n): Kiinankielinen käännös paikallisten asetusten

Pull-pyynnön ehdottaminen

1. Kun muokkaukset on sitoutunut, sinua kehotetaan luomaan pull-pyyntö haarukkaasi GitHub Page.

   

2. Oletuksena kaikkien pull-pyyntöjen pitäisi olla freeCodeCamp main repoa, master haaraa vastaan.

   Varmista, että Base Fork on asetettu freeCodeCamp/freeCodeCamp kun nostat Pull Request.

   

3. Lähetä pull-pyyntö haarasta freeCodeCampin master -haaraan.

4. PR sisältää yksityiskohtaisemman yhteenvedon muutoksista, jotka olet tehnyt ja miksi.

   • Sinut tullaan esittämään pull pyyntö malli . Tämä on tarkistuslista, jota sinun olisi pitänyt seurata ennen pull-pyynnön avaamista.

   • Täytä tiedot niin kuin näette sopivaksi. Nämä tiedot tarkistetaan ja arvioijat päättävät, hyväksytäänkö pull-pyyntösi vai ei.

   • Jos PR:n tarkoituksena on puuttua olemassa olevaan GitHub Issueen, sitten lopussa teidän PR: n kuvauselin, käytä avainsanaa Sulkee viitenumerolla sulkee tämän ongelman automaattisesti, jos PR on hyväksytty ja yhdistetty.

     Esimerkki: Sulkee #123 sulkee ongelman 123

5. Ilmoittakaa, onko olet testannut paikallista kopiota sivustosta vai ei.

   Tämä on erittäin tärkeää, kun tehdään muutoksia, jotka eivät ole pelkästään tekstin sisältöä kuten dokumentaatio tai haasteiden kuvaus. Esimerkkejä paikallista testausta vaativista muutoksista ovat JavaScript, CSS, tai HTML jotka voivat muuttaa sivun toiminnallisuutta tai asettelua.

Palaute pull-pyynnöistä

Onnittelut! 🎉 kun olet tehnyt PR:n ja kiitos paljon siitä, että olet käyttänyt aikaa osallistumiseen.

Moderaattorimme tulevat nyt katsomaan ja jättämään sinulle palautetta. Olkaa kärsivällisiä muiden moderaattoreiden kanssa ja kunnioittakaa heidän aikaansa. Kaikki pull-pyynnöt tarkistetaan aikanaan.

Jos tarvitset apua, keskustele osallistujien chat-huoneesta, olemme enemmän kuin mielellämme auttaa sinua.

[!TIP] Jos haluat osallistua enemmän vetopyyntöjä, suosittelemme, että luet tehdä muutoksia ja synkronoit ohjeet, jottei haarukkaasi tarvitse poistaa.

Ristiriidat pull-pyynnössä

Ristiriitoja voi syntyä, koska monet tietolähteet työskentelevät arkistossa, ja muutokset voivat rikkoa PR:si, joka odottaa arvostelua ja yhdistämistä.

Useammin kuin ei ehkä vaadi rebase, koska me squash all commits, kuitenkin jos perustetta pyydetään tässä on mitä sinun pitäisi tehdä.

Tavallisia korjauksia ja ominaisuuksia varten

Kun työskentelet säännöllisten vikojen ja ominaisuuksien parissa kehityshaarassamme master, voit tehdä yksinkertaisen korjauksen:

1. Luo paikallinen kopio:

   git checkout <pr-branch>
   git pull --rebase ylävirtaan master
   

2. Ratkaise mahdolliset ristiriidat ja lisää / muokkaa commitit

   # Joko
   git add .
   git commit -m "chore: ratkaista ristiriidat"
   
   # Tai
   git add .
   git commit --amend --no-edit
   

3. Paina muutoksesi takaisin PR:ään

   git push --force origin <pr-branch>
   

Tulevat opetussuunnitelmat ja ominaisuudet

Kun työskentelet tulevan opetussuunnitelman ominaisuuksien parissa, seuraava * sivukonttori, sinulla on kirsikkavalinta:

1. Varmista, että ylävirrasi tulee synkronoitua paikallisesi kanssa:

   git checkout master
   git fetch --all --prune
   git checkout next-python-projects
   git reset --hard upstream/next-python-projects
   

2. Ota varmuuskopio

   a. Joko poista paikallinen sivukonttorisi varmuuskopion ottamisen jälkeen (jos sinulla on vielä se paikallisesti):

   git checkout <pr-branch-name>
   
   # example:
   # git checkout feat/add-numpy-video-question
   
   git checkout -b <backup-branch-name>
   
   # example:
   # git checkout -b backup-feat/add-numpy-video-question
   
   git branch -D <pr-branch-name>
   

   b. Tai vain varmuuskopio Pr haarasta (jos sinulla ei ole sitä paikallisesti):

   git checkout -b <backup-branch-name> origin/<pr-branch-name>
   
   # esimerkki:
   # git checkout -b backup-feat/add-numpy-video-question origin/feat/add-numpy-video-question
   

3. Aloita pois päältä puhtaalla liittimellä:

   git checkout -b <pr-branch-name> next-python-projects
   git cherry-pick <commit-hash>
   

4. Ratkaise mahdolliset ristiriidat ja siivoa, asenna suoritettavat testit

   npm run clean
   
   npm ci
   npm run test:curriculum --superblock=<superblock-name>
   
   # example:
   
   # npm run test:curriculum --superblock=python-for-everybody
   
   

5. Jos kaikki näyttää hyvältä työnnä takaisin PR-palveluun

   git push --force origin <pr-branch-name>