GitHub projekti, timovi, vilice i Wiki za dokumentiranje projekata

github projects teams

Ovaj vodič o GitHubu objašnjava koncepte poput GitHub projekata, organizacije i timova, fork repozitorija, izdanja i prekretnice projekta, GitHub Wiki itd.:

U prethodnom uputstvu iz niza vodiča na GitHubu vidjeli smo kako programer može koristiti platformu za pohranu artefakata povezanih s projektom i iste kontrole. Također smo vidjeli koncepte oko zahtjeva za povlačenje, spajanja, grananja i zaštite grana.

Pa, to nije sve. U ovom uputstvu istražit ćemo dublje i saznati što još GitHub može učiniti za programere.

=> Ovdje pogledajte Savršeni vodič za trening za GitHub.

Evo na što ćemo se usredotočiti.

• Stvorite organizaciju i timove
• Razdvojite spremište
• Stvaranje izdanja i prekretnica projekta
• Izradite projektnu ploču
• Izrada GitHub Wiki

Što ćete naučiti:

• Stvorite organizaciju i timove
• GitHub vilica
• GitHub problemi i prekretnice projekta
  • Filtriranje problema
  • Pridruženi problemi za povlačenje zahtjeva
  • Stvaranje ili otvaranje novih izdanja iz izvornog koda
  • Pitanje izdanja
• Odbor za projekt GitHub
• GitHub Wiki za dokumentaciju
  • Omogućavanje Wiki podrške za spremište
  • Stvorite GitHub Wiki
  • Dodajte podnožje
  • Dodajte bočnu traku
  • Pogledajte povijest Wiki
• Zaključak
• Preporučena literatura

Stvorite organizaciju i timove

Kao prethodnik ovog odjeljka, GitHub pruža sljedeće 3 vrste računa.

• Osobni korisnički računi pri čemu možete stvoriti neograničena javna i privatna spremišta i također pozvati suradnike.
• Računi organizacije što je prvenstveno koncept zajedničkih računa i više će se vidjeti u ovom odjeljku.
• Račun poduzeća koju koriste tvrtke koje interno upravljaju politikama za korisnike koji koriste GitHub. To se obično koristi u inačici GitHub Enterprise na lokaciji.

U 1. dijelu vidjeli smo kako je spremište stvoreno pomoću jednog osobnog računa gdje je taj korisnik bio jedan vlasnik spremišta. Ovo je prikladno za male scrum timove u kojima imate 3 do 9 ljudi ili možda još nekolicinu ili je u redu stvoriti spremište za jedan projekt.

Ali što ako postoje veliki Github projekti kojima je potrebno više spremišta i pristup više timova za izvršenje? Ovdje trebamo pogledati kako GitHub Organizacija pomaže u grupiranju više spremišta za jedan veliki projekt. Stoga će također biti više vlasnika jer bi bilo uključeno više spremišta / timova.

Za početak stvaranja nove organizacije kliknite na + u gornjem desnom kutu i odaberite Nova organizacija.

U skladu s tim odaberite plan. Zasad ćemo koristiti besplatni plan koji je Tim za otvoreni izvor.

Unesite detalje o Organizaciji, a zatim kliknite na Sljedeći.

Dodajte članove u organizaciju i kliknite na Dovršite postavljanje.

Sljedeći je korak započeti izradu spremišta prema potrebama projekta i dodati timove u iste.

Možete i kliknuti na Pozovite nekoga za dodavanje članova u upravo stvorenu organizaciju. Kako se dodaju članovi, uloga se također može dodijeliti članu ili vlasniku. Da biste to učinili, idite na narod Tab i odaberite Promjena uloge za tog člana.

Pa, zasad ćemo zadržati jednog korisnika kao vlasnika, a drugog kao člana. Dakle, vlasnik može stvoriti više spremišta i dodijeliti timove odgovarajućim spremištima.

Prije nego što stvorimo spremišta, prvo stvorimo timove. Idite na Timovi karticu i kliknite na Novi tim.

Stvorit ćemo 2 tima, tj. UI tim i Middleware Team.

Kliknite na Stvori tim. Jednom kada se tim stvori, možete dodati članove u tim kao što je prikazano u nastavku.

Slično tome, stvorite drugi tim i dodajte mu članove. Sada možete vidjeti da postoje 2 ekipe.

Krenimo s izradom spremišta. Dakle, kao scenarij, sada ćemo stvoriti 2 spremišta tj. jedan za držanje koda povezanog s korisničkim sučeljem, a drugi za zadržavanje koda međuopreme. Timovi će biti raspoređeni u skladu s tim.

Idite na Spremišta karticu i stvorite a Novo spremište .

Klikni na Izradite spremište dugme. Sljedeće je pružanje pristupa korisničkom sučelju spremištu.

Idite na Timovi tab. Klikni na UI tim i idite na Spremišta tab. Kliknite svaki tim i dodajte spremišta ponovno iz Spremišta tab.

Dodajte spremište unošenjem imena spremišta.

Također osigurajte Napišite dopuštenje za članove tima u ovom spremištu, tj. članovi tima mogu čitati, klonirati i gurati u ovo spremište.

Slično tome, napravite gornje korake za dodavanje spremišta Middleware u drugi tim. Dakle, sada imamo Organizaciju s repozitorijima unutar nje i timove također. Članovi tima mogu klonirati spremište kojem imaju pristup i na njemu raditi.

GitHub vilica

Razdvojite spremište i sinkronizirajte se s izvornim spremištem.

U prethodnim odjeljcima i prethodnom vodiču vidjeli smo kako se stvaraju spremišta i u njih se dodaje izvorni kod. Sad, što ako bi timovi htjeli testirati neke promjene koda kad originalno spremište nije mjesto za to.

Kopija se mora stvoriti za eksperimentiranje s bilo kojim promjenama koda zadržavanjem izvornog spremišta netaknutim. Ovo se zove GitHub Vilica . Da biste stvorili vilicu, idite do spremišta koje je stvoreno na osobnom računu, a ne do organizacije. Kliknite na Vilica s gornje desne strane.

Odaberite račun na kojem trebate razdvojiti izvorno spremište. U ovom slučaju odaberite račun organizacije na kojem će spremište biti račvano.

Spremište je sada račvano kao Demo-Proj-Org / Demo_Project_Repo_VN . Dakle, bilo koji eksperimenti s kodom mogu se izvoditi u račvastom spremištu, a ne u izvornom spremištu.

Ako su u izvornom spremištu izvršene bilo kakve promjene, tada mora biti forkirano spremište sinkronizacija . Opcije naredbenog retka mogu se koristiti da bi se račvasto spremište sinkroniziralo, ali stvaranje zahtjeva za povlačenje jednostavnija je opcija.

Pod pretpostavkom da je izvršena promjena datoteke u izvornom spremištu, nastavite s izradom zahtjeva za povlačenjem.

Kliknite vezu uspoređivati ​​po rašljama.

Odaberite glavu kao izvorno spremište, a bazu kao račvasto spremište kao što je prikazano i kliknite na Stvori zahtjev za povlačenjem.

Kliknite na Spoji zahtjev za povlačenjem i potvrdi spajanje.

Promjene se pojavljuju u račvastom spremištu i sinkroniziraju se s izvornim spremištem.

GitHub problemi i prekretnice projekta

Obično u svakom projektu treba pratiti zadatke, nedostatke, poboljšanja itd. Kao dio napretka. Probleme u GitHubu možete koristiti za praćenje svih gore spomenutih zajedno s projektnim pločama.

S problemima možete isto povezati sa zahtjevima za povlačenjem tako da se automatski može zatvoriti kada se zahtjev za povlačenjem spoji. Također, ako postoje otvoreni problemi, oni se također mogu prenijeti u druga spremišta. U ovom ćemo odjeljku vidjeti mnogo više o tome kako se problemi mogu koristiti.

Stvaranje izdanja i prekretnica

Idite na glavnu stranicu spremišta i idite na Pitanja Tab. Kliknite na Novo izdanje.

Dodijelite ga suradniku na kojem će raditi, dodajte Oznaku da biste ga razlikovali kao poboljšanje. Dobra praksa je spomenuti i o Prekretnica kako bi se pratio napredak pokrenutih problema.

Kliknite na Pošaljite novi broj.

Prikazuje se sažetak izdanja. Imajte na umu da je broj izdanja br. 11 na koji ćemo se kasnije pozvati.

Tema se također može prenijeti u drugo spremište. Opcija za to je na dnu ‘Pitanje prijenosa’.

Dodati Datum dospijeća do prekretnice - R1. Na glavnoj stranici spremišta idite na Pitanja Tab i kliknite na Prekretnice .

Uredi detalje za Milestone R1 i dodajte datum dospijeća. Spremite promjene nakon što ste ih izvršili.

Milestone R1 sada ima 2 otvorena broja, a također se može vidjeti i postotak dovršenosti.

Kliknite Milestone R1 da biste pogledali probleme koji će se isporučiti za ovu prekretnicu. Pitanjima se također može ponovno odrediti prioritet pomicanjem problema gore-dolje.

Filtriranje problema

Pod pretpostavkom da postoji više problema koji su u stanju Otvori / Zatvori i dodijeljeni su više suradnika. Vrlo je bitno tražiti ona pitanja koja se temelje na određenim kriterijima.

Na primjer, sva pitanja koja su vam dodijeljena, svi problemi u otvorenom stanju, itd. GitHub nudi mogućnost pretraživanja za filtriranje problema, pa čak i povlačenje zahtjeva.

Idite na karticu Problemi a u okvir za filtriranje unesite kriterije kako slijedi.

Na primjer, sva otvorena izdanja u otvorenom stanju i dodijeljena suradniku.

vrsta: izdanje stanje: otvoreni primatelj: vniranjan2512 prekretnica: R1 oznaka: poboljšanje

Pridruženi problemi za povlačenje zahtjeva

Kada se Zahtjev za povlačenje uputi na određenu ključnu riječ i broj izdanja i nakon spajanja, problem se automatski zatvara. Čak i ako se na objavu poziva ključna riječ i broj izdanja, problem je zatvoren.

Ključna riječ može biti bilo koja tj. zatvori, zatvori, popravi, popravi, riješi, razriješi.

Na primjer, u spomenutoj poruci zahtjeva za povlačenje ili predaje zatvara # 11.

Izradite zahtjev za povlačenjem i spomenite ključnu riječ i referentni broj kao što je prikazano u poruci. Kliknite na Stvorite zahtjev za povlačenjem i spojite.

Izdanje se automatski zatvara spajanjem zahtjeva za povlačenjem. Svakako je potrebna automatizacija.

Stvaranje ili otvaranje novih izdanja iz izvornog koda

Za sve promjene koda može se otvoriti novo izdanje. Ovime se problemu dodaje URL na liniju promjene koda. U načinu uređivanja koda kliknite na 3 točke (...) pored retka koda i odaberite Referenca u novom broju .

Pojedinosti o izdanju ažurirane.

Pitanje izdanja

Možete prikvačiti problem tako da olakša pronalazak problema i izbjegne duplicirane probleme stvara se.

Otvorite izdanje i u desnom dnu izdanja kliknite na Pitanje pribadače.

Tema je sada dodana iznad popisa izdanja.

Bilješka: U bilo kojem trenutku mogu se prikvačiti najviše 3 izdanja.

Odbor za projekt GitHub

Projektna ploča u GitHub-u pruža jednostavan način za vizualizaciju problema. Možete vidjeti napredak projekta i pogledati koja pitanja tek treba započeti, koja su u tijeku i dovršena izdanja.

Projektna ploča u GitHub-u može se stvoriti na temelju Kanban predložaka koja ima unaprijed definirani tijek rada, a može se i prilagoditi. Primjer će prikazati ploču stvorenu na temelju korisničkog računa.

Na glavnoj stranici spremišta idite na Projekti karticu i stvorite a Novi projekt.

Kao što vidite odozgo, projektna ploča pomaže u:

• Poredaj zadatke
• Planirajte svoj projekt
• Automatizirajte svoj tijek rada
• Pratite napredak
• Status dijeljenja
• Zatvori projekt

Nova projektna ploča s osnovnim Kanban predloškom.

Ploča se kreira s tijekom rada. Dodatni stupci tijeka rada također se mogu dodati klikom na + Dodaj stupac.

Tijek rada također se može automatizirati. Na primjer, ako se stvori novo izdanje, može se izravno dodati u Status obveza. Odaberite Upravljajte automatizacijom opcija za taj status.

Označite potvrdni okvir Novo dodano i kliknite Ažuriranje automatizacije. Dakle, kada se kreira novo izdanje, projekt odabran za izdanje automatski će se dodati u Status obveza. Također možete povući i ispustiti postojeći problem u status i premjestiti s jednog statusa na drugi.

U stupac možete dodati i bilješke koje će osigurati da pružite neke važne informacije o problemima u tom stupcu. Klikni na + potpisati i dodati bilješku.

Kliknite na Dodati.

GitHub Wiki za dokumentaciju

Jedna od vrlo važnih aktivnosti u bilo kojem projektu je stvaranje i održavanje dokumentacije za vaše spremište za korištenje cijelog tima. GitHub spremište dolazi s podrškom za stvaranje takve dokumentacije pomoću GitHub Wiki. Dakle, sve informacije o vašem projektu i njegovoj uporabi mogu se zabilježiti u wikiju.

Wikiji su dostupni za javna spremišta u GitHubu besplatno. Wikiji koriste knjižnicu označavanja otvorenog koda. Vidjet ćemo kako se koristiti ovom knjižnicom dok pišem wikije.

Omogućavanje Wiki podrške za spremište

Na glavnoj stranici spremišta kliknite na Postavke tab i osigurajte da Wikiji opcija je odabrana pod Značajke odjeljak.

Stvorite GitHub Wiki

Na glavnoj stranici spremišta idite na Wiki tab. Kliknite na Stvorite prvu stranicu.

Unesite naslov i dodajte tekst na Wiki. Također, možete koristiti opciju oblikovanja pomoću Markdown podrške. Klikni na Spremi stranicu jednom učinjeno.

Napomena u gornjem sadržaju # je za naslov1, ## je za naslov2, ### je za naslov3. * koristi se za neuređeni popis. Pregled će biti prikazan dolje.

Dodajte podnožje

Na Wiki kliknite na karticu + Dodajte prilagođeno podnožje.

Dodajte sadržaj i spremite stranicu.

Otvorite bilo koji spremljeni Wiki i vidjet ćete podnožje.

Dodajte bočnu traku

Na wiki kartici kliknite na + Dodajte prilagođenu bočnu traku.

Dodajte sadržaj bočne trake i spremite stranicu.

Otvorite bilo koji wiki i vidjet ćete bočnu traku.

Pogledajte povijest Wiki

U povijesti možete pogledati tko je izvršio promjenu, poslati poruke i datum kada je promjena izvršena.

Otvorite Wiki i uredite stranicu. Kliknite na Povijest stranice, s desne strane.

Kliknite Hash da biste pogledali promjene. Odaberite revizije za usporedbu promjena i poništavanje promjena novije revizije. Kliknite na Vrati promjene.

world of warcraft privatni poslužitelj vanilla

Izmjene su vraćene na stariju reviziju.

Bilješka : Možete vratiti promjene na temelju dopuštenja za uređivanje Wiki-a.

Zaključak

U 1. i 2. dijelu GitHub serije vidjeli smo o aktivnostima kontrole verzija, stvaranju spremišta, zahtjevima za povlačenjem, granama, pregledima koda, organizacijama i timovima, formiranju spremišta, oznakama, prekretnicama, izdanjima, GitHub projektima, Wikisima.

U našem nadolazećem vodiču osvrnut ćemo se na stvaranje izdanja, integraciju s Jirom i nekolicinom Git naredbe koji će pomoći programerima prije nego što potaknu promjene na GitHub spremištu.

Nadamo se da će svim programerima ovaj praktični pristup za GitHub biti koristan u njihovim projektima.

=> Posjetite ovdje za ekskluzivnu seriju GitHub Training Tutorial.

Preporučena literatura

• Vrste rizika u softverskim projektima
• Vodič za programere za GitHub | Kako koristiti GitHub
• Kako koristiti Microsoft TFS za JAVA projekte s Eclipseom u DevOpsu
• JIRA Agile Tutorial: Kako učinkovito koristiti JIRA za upravljanje agilnim projektima
• Kako se razlikuje planiranje ispitivanja za ručne i automatizacijske projekte?
• Primjeri utvrđivanja selena - praktična primjena u projektima
• Onsite - Offshore model projekata testiranja softvera (i kako to učiniti za vas)
• Git vs GitHub: Istražite razlike na primjerima