Hogyan készítheti el első lekérési kérelmét a GitHubon

Mi az elágazás?

Amikor szeretjük valaki adattárát, és szeretnénk, ha a GitHub-fiókunkban lenne, akkor elágazunk, hogy külön dolgozhassunk vele.

Amikor egy adattárat elágazunk, kapunk egy példányt az egész tárról, annak teljes történetével. Elágazás után bármit megtehetünk, anélkül, hogy befolyásolnánk az eredeti verziót.

Mi a húzási kérelem?

A lekérési kérelmek hozzájárulnak a csoportos projektekhez vagy a nyílt forráskódú projektekhez.

Például egy felhasználó, aki Harry elágazik a ThanoshanMV adattárán, és módosításokat hajt végre az adott táron. Most Harry húzási kérelmet intézhet a ThanoshanMV-hez, de a ThanoshanMV feladata, hogy elfogadja vagy elutasítsa. Olyan ez, mintha azt mondanád: "ThanoshanMV, kérlek, szívesen meghúznád a változásaimat?"

Mit jelent a közreműködés

Nemcsak kóddal járulhatunk hozzá egy nyílt forráskódú projekthez, hanem sok más módon is hozzájárulhatunk. Ezen módszerek közül néhányat az alábbiakban ismertetünk.

Ahogy a 99xtechnology informatikai cég hacktitude kezdő útmutatója mondja, a következő módszerekkel járulhatunk hozzá egy nyílt forráskódú projekthez:

  1. Tervezés: Megtervezheti a projekt elrendezését annak használhatóságának javítása érdekében, javíthatja a projekt navigációját és menüjét a felhasználói kutatási programok alapján, művészeteket készíthet logókhoz vagy pólókhoz, és stílusú útmutatásokat adhat a projekthez.
  2. Írás: Megírhatja és továbbfejlesztheti a projekt dokumentációját, vagy lefordíthatja a dokumentációt, elindíthat egy hírlevelet a projekthez, vagy írhat oktatóanyagokat a projekthez, és előkészítheti a kiemeléseket a levelezőlistáról, vagy összeállíthat egy mappát, amely példákat mutat be a projektek használatáról.
  3. Szervezés: Összekapcsolhatja ismétlődő kérdéseket, javasolhat új kiadási címkéket, javasolhatja a régi nyitott kérdések lezárását és kérdéseket tehet fel a nemrégiben megnyitott kérdésekről a vita továbblépése érdekében.
  4. Segítsen másoknak: Válaszoljon a nyitott kérdésekre vonatkozó kérdésekre, olvassa el a mások beadványainak kódját, és ajánljon fel egy másik közreműködőt.
  5. Kódolás: Segítsen megoldani minden nyitott kérdést, kérdezze meg, hogy tud-e új funkciókat biztosítani, valamint javíthatja-e az eszközöket és a tesztelést.

Tegyük meg az első húzási kérelmünket!

Ha még nem ismeri a Git & GitHub szolgáltatást, kérjük, olvassa el a Git & GitHub kezdő útmutatóját.

1. A tároló elágazása

Az oldal tetején található villa gombra kattintva forkolja el a tárat. Ez létrehozza az egész lerakat egy példányát a fiókjában.

2. Klónozza a tárat

Miután a lerakat a fiókjában van, klónozza a gépére, hogy helyben dolgozzon vele.

A klónozáshoz kattintson a klón gombra, és másolja a linket.

Nyissa meg a terminált, és futtassa a következő parancsot. Helyileg klónozza az adattárat.

$ git clone [HTTPS ADDRESS]

Most létrehoztuk a fő ág másolatát a fő online projekttárból.

A parancs futtatásával el kell mennünk abba a klónozott könyvtárba:

$ cd [NAME OF REPOSITORY]

3. Hozzon létre egy fiókot

Jó gyakorlat, ha új fiókot hozunk létre, amikor a tárakkal dolgozunk, legyen az akár egy kis projekt, akár egy csoport munkájához való hozzájárulás.

A fióktelepnek rövidnek kell lennie, és tükröznie kell az általunk végzett munkát.

Most hozzon létre egy ágat a következő git checkoutparanccsal:

$ git checkout -b [Branch Name]

4. Végezzen változtatásokat és hajtsa végre őket

Végezze el a projekt lényeges változtatásait és mentse el.

Ezután hajtsa végre git status, és látni fogja a változásokat.

Adja hozzá ezeket a módosításokat az imént létrehozott ághoz a következő git addparanccsal:

$ git add .

Most hajtsa végre ezeket a módosításokat a következő git commitparanccsal:

$ git commit -m "Adding an article to week 02 of articles of the week"

5. Nyomja meg a változásokat a GitHub-ra

A GitHub változásainak végrehajtásához meg kell határoznunk a távvezérlő nevét.

$ git remote

Ennél az adattárnál a távvezérlő neve „origó”.

A távirányító nevének azonosítása után nyugodtan áttölthetjük ezeket a változásokat a GitHub-ra.

git push origin [Branch Name]

6. Hozzon létre húzási kérelmet

Látogasson el a GitHub tárházába, és megjelenik egy „Összehasonlítás és húzás kérése” gomb, és kattintson rá.

Kérjük, adja meg a szükséges részleteket arról, hogy mit tett (a „#” segítségével hivatkozhat a problémákra). Most nyújtsa be a húzási kérelmet.

Gratulálunk! Ön megtette az első húzási kérését.  

Ha a kérését elfogadják, e-mailt fog kapni.

7. Szinkronizálja a villás főágat

Mielőtt bármilyen lekérési kérelmet benyújtana az eredeti adattárhoz, szinkronizálnia kell az adattárat az eredetivel.

Még akkor is, ha nem fog lekérési kérelmet benyújtani az eredeti lerakathoz, jobb szinkronizálni az eredeti lerakattal, mivel néhány további funkció és hibajavítás megtörtént, mióta az eredeti adattárat elágazta.

Kövesse az alábbi lépéseket a módosítások frissítéséhez / szinkronizálásához a fő fiókhoz:

  1. Először ellenőrizze, melyik fiókban van.
$ git branch

Ez felsorolja az összes ágat, és zöld színnel jelzi az aktuális vagy az aktív ágat.

2. Váltson a főágra.

$ git checkout master

3. Adja hozzá az eredeti adattárat upstream tárhelyként.

Annak érdekében, hogy a módosításokat az eredeti adattárból az elágazó verzióba lehessen vinni, hozzá kell adnia az eredeti Git-tárat upstream tárhelyként.

$ git remote add upstream [HTTPS]

Itt a [HTTPS] az az URL, amelyet át kell másolnia a tulajdonos adattárából.

4. Hozza le a tárat.

Az összes módosítás lekérése az eredeti adattárból. Az eredeti adattárhoz való vállalások az upstream / master nevű helyi fiókban kerülnek tárolásra.

$ git fetch upstream

5. Egyesítsd.

Egyesítse a változásokat az upstream / masterből a helyi master fiókba. Ez szinkronba hozza a villa főágát az upstream tárral, anélkül, hogy elveszítené a helyi változtatásokat.

$ git merge upstream/master

6. Nyomja meg a GitHub módosítását

Ezen a ponton a helyi fiók szinkronizálva van az eredeti adattár fő ágával. Ha frissíteni kívánja a GitHub-adattárat, meg kell adnia a módosításokat.

$ git push origin master

MEGJEGYZÉS: A villás főág szinkronizálása után eltávolíthatja azt a távvezérlőt, ha akarja. De a jövőben is frissítenie / szinkronizálnia kell az adattárat, ezért a legjobb gyakorlat megtartani.

$ git remote rm [Remote Name]

8. Törölje a felesleges ágat

Az ágakat speciális célból hozzák létre. Amint ez a cél megvalósult, ezekre az ágakra nincs szükség, ezért törölheti őket.

$ git branch -d [Branch Name]

A GitHubon is törölheti annak verzióját.

git push origin --delete [Branch Name]

Következtetés

A GitHub egy hatékony eszköz a verzióelőzmények ellenőrzésére. Mindenki hozzájárulhat a nyílt forráskódú projektekhez húzási kérelmek benyújtásával. A közreműködések nem mindig kódolódnak - más módon is lehet hozzájárulni.

Végül el kell mondanom, hogy ne aggódjon, ha a kéréseit elutasítják. A fenntartók sok időt töltenek projektjeik fejlesztésével, és sokkal többet tudnak a projektjeikről, mint mi. Tehát ne aggódjon, ha a kérését nem egyesítik.

Maradj erős, maradj pozitív, és soha ne add fel.

- Roy T. Bennett, A fény a szívben

Ezt a cikket eredetileg a Médiumon tették közzé.

A Twitteren kapcsolatba léphet velem és kapcsolatba léphet velem.

Hozzájárulás a nyílt forráskódú világhoz!