Vetopyyntö (PR) on GitHub-ominaisuus, jonka avulla voit ehdottaa muutoksia arkistoon, johon sinulla ei ole kirjoitusoikeutta. Tietovaraston ylläpitäjät voivat tarkistaa nämä muutokset ja halutessaan yhdistää ne alkuperäiseen arkistoon.
Vetopyyntöjen avaaminen GitHubissa on ratkaisevan tärkeää avoimen lähdekoodin projekteihin osallistumisessa ja yhteistyössä muiden kehittäjien kanssa. Opi luomaan ja avaamaan vetopyyntö GitHubissa muutamalla helpolla vaiheella.
Vaihe 1: Arkiston haarautuminen
Arkiston muodostaminen päälle GitHub-alustalla luo kopion – joka tunnetaan myös nimellä "haarukka" - kyseisestä arkistosta tilillesi. Arkiston haaroittamisen avulla voit tehdä muutoksia koodiin vaikuttamatta alkuperäiseen arkistoon.
Voit muodostaa arkiston siirtymällä sen pääsivulle ja napsauttamalla haarukka painiketta oikeassa yläkulmassa:
Täytä arkiston nimi (haarukka) ja valinnainen kuvaus ja napsauta Luo haarukka:
Nyt olet luonut kopion alkuperäisestä arkistosta. Tällä uudella arkistolla on yhteys alkuperäiseen, joten koodiin tekemiäsi muutoksia voidaan helposti verrata ja yhdistää takaisin siihen.
Vaihe 2: Muutosten tekeminen koodiin
Kun olet haaroittanut arkiston, saatat joutua kloonaamaan sen paikalliselle koneellesi riippuen ehdotettavien muutosten määrästä ja luonteesta. Jos teet hyvin yksinkertaisia muutoksia, joita sinun ei tarvitse testata, voit tehdä sen verkossa käyttämällä GitHub-verkkopohjainen editori.
Jos haluat kloonata arkiston paikalliseen koneellesi Gitin avulla, suorita tämä päätekomento:
git klooni
Korvata arkistosi URL-osoitteella – löydät tämän GitHubista. Tämä komento kloonaa arkiston paikalliselle koneellesi, jossa voit vapaasti kokeilla ja tehdä muutoksia koodiin.
Muutokset kannattaa pitää pieninä ja kohdennettuina, sillä suurten vetopyyntöjen tarkistaminen ja yhdistäminen voi olla haastavaa. Pyri pitämään muutokset tietyn ongelman tai ominaisuuden mukaan, jotta ylläpitäjien on helpompi tarkistaa ja hyväksyä ne.
Kun olet tehnyt haluamasi muutokset paikallisesti, sitoudu ne ja työnnä ne GitHub-haarukkaan käyttämällä Gitiä.
Vaihe 3: Vetopyynnön avaaminen
Kun olet tehnyt muutokset GitHubiin, sinun pitäisi nähdä kehote, joka varoittaa, että haarasi on "sitoutunut" ennen arkistoa, josta se haaroitti, esimerkiksi:
Klikkaa Osallistu pudota alas. Napsauttamalla tätä painiketta sinua pyydetään avaamaan vetopyyntö. Napsauta sitten Avaa vetopyyntö painike:
Joillakin arkistoilla on erityisiä lisäohjeita, jotka löytyvät yleensä CONTRIBUTING.md-tiedostosta ja joita sinun on noudatettava. Muista lukea nämä ohjeet ja noudattaa niitä ennen kuin lähetät vetopyynnön.
Täytä seuraavaksi vaaditut kentät ja napsauta Luo vetopyyntö painike:
Sitoutumisviestisi tulee olla selkeä ja ytimekäs, ja siinä tulee kuvata tekemäsi muutokset ja niiden taustalla olevat perustelut. Tämä auttaa ylläpitäjiä ymmärtämään tekemäsi muutokset ja helpottaa koodin tarkistamista.
Kun olet luonut pullon, sinun on odotettava, että projektin ylläpitäjät tarkistavat ja yhdistävät sen tai sulkevat sen. Ylläpitäjillä voi olla ehdotuksia tai palautetta vetopyyntöösi. Ole avoin muutoksille ja valmis tekemään muutoksia, jos he sinua pyytävät.
Vetopyyntöjen merkitys
Vetopyynnöt helpottavat kehittäjien välistä yhteistyötä antamalla heille mahdollisuuden ehdottaa muutoksia, antaa palautetta ja tarkistaa koodia. Tämä auttaa edistämään yhteisöllisyyden ja yhteistyön tunnetta projektin sisällä, mikä johtaa enemmän panoksiin ja nopeampaan kehitykseen.
Lisäksi vetopyynnöt järjestävät projektin historian ja versioinnin antamalla ylläpitäjille mahdollisuuden seurata koodin eri versioita ja kuhunkin versioon tehtyjä muutoksia.
