Yhdistä GitHub

Notionin ja GitHubin välinen yhteys mahdollistaa kehitystyönkulkujen saumattoman yhdistämisen. Voit linkittää GitHub-sisältöä suoraan Notion-sivuille, tuoda GitHub-tietoja Notion-tietokantoihin ja synkronoida pull requesteja Notion-tehtävien kanssa, jotta tiimisi pysyy ajan tasalla projektien tilasta. Lue lisää yhteyden eri ominaisuuksista ja niiden määrittämisestä.

Sinun on oltava sekä Notion-työtilan omistaja että GitHub-organisaation ylläpitäjä, jotta voit yhdistää Notionin ja GitHub-työtilasovelluksen.

1. Siirry sivuvalikossa kohtaan Settings → Connections.

2. Etsi GitHub (Workspace).

3. Napsauta Connect ja suorita todennusprosessi.

Linkitä tiedostoon tai tiedoston tiettyihin riveihin suoraan Notionissa. Voit jopa linkittää tietystä commitista tai branchista, jos haluat viittaamasi koodin olevan ajan tasalla.

1. Kopioi haluamiesi rivien permalink GitHubista.

2. Liitä se Notion-sivulle ja valitse Paste as preview, jotta koodi upotetaan sivullesi.

Voit synkronoida GitHub-tietovarastosi (mukaan lukien pull requestit ja issuet) Notion-tietokannoiksi. Tee näin:

1. Kopioi GitHubissa linkki PR-pyyntöön tai issueen.

2. Liitä linkki Notion-sivulle ja valitse Paste as database.

   • Jos et ole vielä tehnyt niin, sinua pyydetään kirjautumaan sisään ja yhdistämään Notion ja GitHub-käyttäjätilisi.

3. Synkronoitu tietokanta luodaan /taulukkonäkymä-tilassa, ja kaikki GitHub-ominaisuudet lisätään automaattisesti.

4. Tietokanta alkaa täyttyä automaattisesti ja jatkaa synkronoitumista, jos siirryt pois sivulta.

Tässä on luettelo tukemistamme GitHub-ominaisuuksista:

Otsikoita ja tunnisteita ei tueta tällä hetkellä.

Voit käyttää identiteetin yhdistämistä yhdistääksesi GitHub-identiteetit tiimisi Notion-profiileihin. Tee se näin:

1. Siirry GitHub email settings -kohtaan ja varmista, että Keep my email addresses private -asetus ei ole valittuna.

2. Muokkaa GitHub-profiiliasi (https://github.com/{YOUR_USERNAME_HERE}) ja lisää Notion-sähköpostiosoitteesi.

Tämä mahdollistaa identiteettisi yhdistämisen synkronoituihin tietokantoihin työtiloissa, joissa olet jäsen.

Notion-tietokantasi GitHub Pull Request -ominaisuus pitää tiimisi automaattisesti ajan tasalla tehtävien tiloista. Siinä on myös monia määritteitä, joita voit käyttää koosteissa, kaavoissa ja suodattimissa.

1. Napsauta Notion-tietokannassa + lisätäksesi uuden ominaisuuden.

2. Etsi ja napsauta GitHub Pull Requests lisätäksesi tämän ominaisuuden tietokantaasi.

   • Jos et näe GitHub Pull Requests -ominaisuusluetteloa, siirry kohtaan Settings → More Settings → Connections → Lisää GitHub Pull Request.

3. Varmista, että tietokannassasi on Unique ID property. Tämä ominaisuus lisätään tietokantaasi, jos siinä ei vielä ole sellaista.

4. Käyttääksesi GitHub Pull Request -ominaisuutta, varmista, että olet yhdistänyt GitHub-käyttäjätilisi Notioniin. Lisää sen jälkeen Notion-tehtävän yksilöllinen tunniste (Unique ID) pull requestiin tai liitä GitHubin pull requestin URL-osoite ominaisuuteen.

Notion ottaa oletuksena käyttöön paluulinkit Notion-tehtävistä GitHubiin. Jos haluat poistaa tämän käytöstä, napsauta tietokantasi GitHub Pull Request -ominaisuutta → Edit property. Kytke Linkbacks in GitHub pois päältä.

Voit käyttää GitHub Pull Requests -ominaisuutta tehtäviesi tilan päivittämiseen automaattisesti Notionissa.

1. Valitse GitHub Pull Requests -ominaisuutesi otsikko ja napsauta Edit property.

2. Etsi Auto-update -osio ja valitse avattavasta valikosta se tila, jonka haluat päivittää.

3. Valitse tehtävän tila, joka asetetaan, kun GitHub PR on avattu, katselmoitavaksi pyydetty, hyväksytty tai yhdistetty.

4. Nyt kun PR etenee GitHubissa, Notion-tehtäväsi tila päivittyy automaattisesti asetustesi mukaan.

Voit myös näyttää GitHub-toiminnan linkitetyssä Notion-tehtävässä. Tee tämä napsauttamalla tietokantasi GitHub-ominaisuutta → Edit property. Ota käyttöön Activity Comments.

Jos haluat linkittää GitHub PR:n yhteen tai useampaan Notion-tehtävään, syötä PR:n kuvaukseen taikasana ja Notion-tehtävien yksilöllinen tunnus.

Taikasanat ovat avainsanoja, jotka auttavat luomaan yhteyksiä Notion-tehtävien ja GitHub PR -pyyntöjen välille. Voit käyttää mitä tahansa seuraavista sanoista:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• liittyy kohteeseen

• contributes to

• towards

PR-kuvauksesi voisi olla esimerkiksi ”fixes CTT-13”. Kun kuvaus on asetettu, Notion-tehtäväsi, jonka tunnus on CTT-13, linkitetään kyseiseen PR:ään.

Jos PR-kuvauksessasi käytetään taikasanoja, jotka liittyvät tehtävän sulkemiseen tai viimeistelyyn, Notion-tehtävä merkitään Valmis-tilaan, kun PR yhdistetään.

Jos PR-kuvauksessasi käytetään taikasanoja, jotka liittyvät tehtävään viittaamiseen tai siihen liittymiseen, Notion-tehtävää ei merkitä Valmis-tilaan, kun PR yhdistetään.

Voit linkittää Notion-tehtäviä vain viitteiksi, jolloin kyseisiä tehtäviä ei merkitä Valmis-tilaan.

GitHubin yhteyden katkaiseminen Notion-työtilasta edellyttää, että olet Notion-työtilan Omistaja.

1. Siirry kohtaan Settings.

2. Valitse Connections.

3. Valitse GitHubin kohdalta ••• → Disconnect all users.

Kun katkaiset GitHubin yhteyden Notion-työtilaan, kukaan työtilasi käyttäjistä ei voi käyttää yhteyttä ennen kuin se on määritetty uudelleen.