A lekérési kérelem (PR) egy GitHub-szolgáltatás, amely lehetővé teszi, hogy változtatásokat javasoljon egy olyan adattárhoz, amelyhez nincs írási hozzáférése. A lerakatkarbantartók áttekinthetik ezeket a változtatásokat, és ha úgy döntenek, egyesíthetik őket az eredeti lerakattal.
A lehívási kérelmek megnyitása a GitHubon kulcsfontosságú a nyílt forráskódú projektekhez való hozzájárulásban és a más fejlesztőkkel való együttműködésben. Néhány egyszerű lépésben megtudhatja, hogyan hozhat létre és nyisson meg lehívási kérelmet a GitHubon.
1. lépés: Az adattár elágazása
Elágazás egy adattárat a GitHub platform létrehoz egy másolatot – más néven "villát" - a tárhelyről az Ön fiókja alatt. A lerakat elágazása lehetővé teszi a kód módosítását anélkül, hogy az eredeti tárházat érintené.
Egy tárhely elágazásához navigáljon a főoldalára, és kattintson a gombra Villa gomb a jobb felső sarokban:
Töltse ki a tároló nevét (fork) és egy opcionális leírást, majd kattintson Hozzon létre villát:
Most létrehozta az eredeti tár másolatát. Ez az új tárhely kapcsolatban áll az eredetivel, így a kódon végzett bármilyen változtatás könnyen összehasonlítható és visszaolvasztható.
2. lépés: A kód módosítása
Miután elágazta a tárat, előfordulhat, hogy a helyi gépre kell klónoznia, a javasolt változtatások mennyiségétől és jellegétől függően. Ha nagyon egyszerű változtatásokat hajt végre, amelyeket nem kell tesztelnie, megteheti online használatával a GitHub web-alapú szerkesztő.
Egy lerakat klónozásához a helyi gépre a Git használatával futtassa ezt a terminálparancsot:
git klón
Cserélje ki a tárhely URL-jével – ezt megtalálhatod a GitHubon. Ez a parancs klónozza a tárolót a helyi gépre, ahol szabadon kísérletezhet és módosíthat a kódon.
A változtatásokat kicsiben kell tartania és célzottan, mivel a nagy lekérési kérelmek felülvizsgálata és egyesítése kihívást jelenthet. Próbálja meg a változtatásokat egy-egy problémára vagy szolgáltatásra korlátozni, hogy a karbantartók könnyebben áttekinthessék és elfogadhassák azokat.
Miután elvégezte a kívánt változtatásokat helyileg, véglegesítse azokat, és tolja őket a GitHub-elágazásba Git használatával.
3. lépés: Lehívási kérelem megnyitása
Miután végrehajtotta a módosításokat a GitHubon, egy figyelmeztető üzenetnek kell megjelennie, amely figyelmezteti Önt, hogy az ága több „commit” művelettel rendelkezik a tároló előtt, például:
Kattints a Hozzájárul ledob. Erre a gombra kattintva meg kell nyitnia egy lehívási kérelmet. Ezután kattintson a Nyissa meg a lehívási kérelmet gomb:
Egyes adattárak speciális hozzájárulási irányelvekkel rendelkeznek, amelyeket általában egy CONTRIBUTING.md fájlban találhat meg, és amelyeket be kell tartania. A lehívási kérelem benyújtása előtt feltétlenül olvassa el és kövesse ezeket az irányelveket.
Ezután töltse ki a szükséges mezőket, és kattintson a gombra Lehívási kérelem létrehozása gomb:
A kötelezettségvállalási üzenetnek világosnak és tömörnek kell lennie, és le kell írnia az Ön által végrehajtott változtatásokat és azok indokait. Ez segít a karbantartóknak megérteni a változtatásokat, és megkönnyíti számukra a kód áttekintését.
Miután létrehozta a lehívást, meg kell várnia, amíg a projekt karbantartói áttekintik és egyesítik vagy bezárják. A karbantartóknak lehetnek javaslatai vagy visszajelzései a lehívási kérelmével kapcsolatban. Legyen nyitott a változtatásokra, és hajlandó átdolgozni, ha kérik.
A lehívási kérések jelentősége
A lehívási kérelmek megkönnyítik a fejlesztők közötti együttműködést azáltal, hogy változtatásokat javasolhatnak, visszajelzést adhatnak, és áttekinthetik a kódot. Ez elősegíti a közösség és az együttműködés érzését a projekten belül, ami több hozzájáruláshoz és gyorsabb fejlődéshez vezet.
Ezen túlmenően a lehívási kérelmek megszervezik a projekt előzményeit és verziószámát, lehetővé téve a karbantartók számára, hogy nyomon kövessék a kód különböző verzióit és az egyes verziókon végrehajtott módosításokat.