Tiedoston merkitseminen katsotuksi GitHub-sovelluksessa

GitHub on Microsoftin omistama verkkoalusta, jota käytetään koodin isännöintiin. Sitä käytetään versionhallintaan ja yhteistyöhön, ja sen avulla kehittäjät voivat työskennellä projektin parissa samanaikaisesti mistä tahansa.

GitHubissa kehittäjät voivat helposti luoda arkistoja, joita yleensä käytetään projektien järjestämiseen. Nämä arkistot voivat sisältää kansioita, tiedostoja, kuvia, videoita, laskentataulukoita, tietojoukkoja tai mitä tahansa projektisi tarvitsemaa. Niiden mukana tulee myös Readme.md-tiedosto, jossa voit kuvata projektiasi ja antaa tietoja siitä.

Kuinka luoda arkisto

Noudata näitä ohjeita luodessasi arkiston.

Napsauta  + , joka sijaitsee sivun oikeassa yläkulmassa. Valitse sitten  Uusi arkisto.

Valitse arkistollesi nimi (käytän "Hei kaikki").

Kirjoita lyhyt kuvaus arkistosta.

Valitse  Alusta tämä arkisto README:llä.

Napsauta  Luo arkisto  -painiketta.

Kuinka luoda haara

Kun eri kehittäjät haluavat työskennellä saman asiakirjan parissa samanaikaisesti, he käyttävät GitHubin ominaisuutta nimeltä Branching. Oletusarvoisesti, kun luot arkiston, siinä on vain yksi haara, jota kutsutaan päähaaroksi. Haaroja käytetään koodin kokeiluun tai muokkaamiseen ennen kuin ne lopulta määritetään päähaaralle.

Kun haara luodaan päähaaraan, uusi toimisto on kopio päähaarasta osaston luomishetkellä. Lisäksi, jos joku tekee muutoksia päähaaraan haaran luomisen jälkeen, voit tehdä muutokset uuteen haaraasi.

Uuden haaran luomisen vaiheet

Siirry uuteen arkistoosi "Hei, kaikki".

Napsauta tiedostoluettelon yläosassa olevaa avattavaa valikkoa, jossa lukee  haara: master.

Kirjoita uuden haaran tekstiruutuun nimi, esimerkiksi "illusBranch".

Napsauta  Luo haara  -ruutua tai napauta " Enter" näppäimistöllä.

Muutosten tekeminen ja toteuttaminen

Olet nyt koodinäkymässä "illusBranchille", joka on kopio päähaarasta. GitHub-alustalla kaikki tekemäsi ja tallentamasi muutokset kutsutaan "sitoumuksiksi". Heillä on liitteenä merkintä, joka kertoo, mitkä muutokset olivat.

Tee ja tee muutoksia

Napsauta ensin  Readme.md-  tiedostoa.

Napsauta seuraavaksi kynäkuvaketta tiedostonäkymän oikeassa kulmassa. Sen avulla voit muokata koodia.

Kun editori avautuu, kirjoita muutokset, jotka haluat tehdä.

Kirjoita vahvistusviesti, joka parhaiten kuvaa readme.md-tiedostoon tekemiäsi muutoksia.

Napsauta  Vahvista muutokset  -painiketta.

Vetopyynnön avaaminen

Olet nyt tehnyt muutoksia pääkäyttäjän haaraan ja voit vetää pyynnön. Kun avaat vetopyynnön, esität ehdottamasi muutokset ja pyydät muilta tarkistusta. Jos tarkistajat hyväksyvät tekemäsi muutokset, he yhdistävät ehdottamasi muutokset omiin haaroihinsa. Vetopyynnöt osoittavat eroja molempien haarojen sisällössä. Kaikki muutokset näkyvät joko punaisina tai vihreinä. Pääset sitoumukseen vetopyynnöllä heti sen luomisen jälkeen avataksesi keskustelun siitä.

Kuinka merkitä tiedostot katsotuiksi

Suurten koodikantojen parissa työskentelevien kehittäjien on harvinaista välttää suuria vetopyyntöjä. Tiedostojen etsiminen ja tarkistaminen voi kestää useita tunteja. Etsimiseen käytetty aika saa jonkun helposti unohtamaan missä hän oli. Helppo tapa pitää kirjaa tarkistamistasi tiedoista on merkitä tiedostot katsotuiksi.

Vaiheet tiedoston merkitsemiseksi katsotuksi

Näet edistymisesi vetopyynnön yläosassa. Tässä näet tiedostot, joita olet katsellut ja joita et ole vielä nähnyt. Kun merkitset tiedoston katsotuksi, se kutistuu automaattisesti, mikä helpottaa sen tarkastelua.

Alla olevat kuvat auttavat havainnollistamaan vaiheita.

Luo  vetopyyntö.

Avaa Pull-pyyntö nähdäksesi kaikki äskettäin lisätyt tai muokatut tiedostot.

Napsauta tiedostoa merkitäksesi sen katsotuksi. Tämä tiivistää tiedoston.

​

​

​

Tiedoston merkitseminen on kätevä GitHubin ominaisuus, joka auttaa arvioijia keskittymään työhönsä ja seuraamaan edistymistään helposti. Katsottu-ominaisuus ilmoittaa myös, kun jokin muuttuu jo katsomassasi koodissa.

Jos esimerkiksi avaat tiedoston ja joku myös tarkistaa ja muuttaa mitä tahansa koodia sen jälkeen, kun olet jo tehnyt niin, Katselutila muuttuu "Muutettu edellisen katselun jälkeen". Näin voit myös tarkistaa, mitä muut ovat muuttaneet arvostelujensa aikana.

Käärimistä

Uuden projektin koodaaminen itse voi tuntua pelottavalta, joten älä tee sitä yksin! Microsoft on tehnyt yhteistyöstä helppoa ja tehokasta GitHubin kanssa.