GitHub

Spremljaj aktivnost javnih in zasebnih repozitorijev poleg ostalih podatkov projekta.

Kaj dobiš

Metric	How it’s counted	Period value
Commits	Commits on the default branch, by commit date	Sum of the days
PRs merged	Pull requests merged, by merge date	Sum of the days
Lines changed	Lines added plus lines removed, leaving out merge commits	Sum of the days
Open issues	Issues open right now (pull requests excluded)	Latest observation

Releases postanejo dogodki na projektu, da vidiš, kaj je bilo izdano kdaj.

Dnevi se štejejo v UTC. Odprte težave se pokažejo le, če ima repozitorij vključene issue.

Activity, not productivity

Te številke opisujejo aktivnost repozitorija. Niso merilo dela posameznika in en velik commit lahko pomeni manj kot deset majhnih.

Korak 1: Ustvari žeton

Fine-grained personal access token ti omogoči natančno izbrati repozitorije, ki jih Metribay lahko bere, z read-only dostopom.

1. Na GitHub odpri Settings → Developer settings → Personal access tokens → Fine-grained tokens in izberi Generate new token.

2. Daj mu ime, na primer »Metribay«, in izberi datum poteka.

3. Pod Resource owner izberi sebe ali organizacijo, ki ima repozitorije.

4. Pod Repository access izberi Only select repositories in izberi repozitorije.

5. Pod Permissions → Repository permissions nastavi na Read-only:

   • Contents
   • Issues
   • Pull requests

   Metadata se doda sam kot read-only.

6. Izberi Generate token in ga kopiraj. GitHub ga pokaže le enkrat.

Nekatere organizacije morajo odobriti fine-grained žetone. Če repozitoriji ne izstopijo, prosi lastnika organizacije za odobritev.

Plan for expiry

Ko žeton poteče, vir kaže Needs attention. Nastavi opomnik, ustvari novega pred potekom in posodobi povezan račun.

Korak 2: Poveži v Metribay

1. Na strani projekta izberi Add data source in GitHub.

2. Odpri Connect an account with your own credentials in prilepi žeton v Personal access token.

3. Izberi Save account and continue.

4. Izberi repozitorij s seznama.

5. Izberi Add and start import.

Vnesi repozitorij ročno

Odpri Enter it manually in vpiši owner/repository, na primer octocat/hello-world.

Drugi načini prijave

Classic personal access token. Deluje tudi. Za javne repozitorije ne potrebuje scopeov. Za zasebne potrebuje repo, ki daje tudi pisanje, zato raje fine-grained žeton.

GitHub App. Če imaš lastno GitHub App, odpri Use a GitHub App instead in izpolni Client Id, Installation Id in GitHub App private key (PEM). Aplikaciji daj read-only Contents, Issues in Pull requests. Pri aplikaciji repozitorije vnašaš ročno: seznam ni na voljo.

Dobro vedeti

• Prvi uvozi lahko trajajo pri zasedenih repozitorijih, ker Metribay prebere vsak commit, pull request in izdajo v oknu zgodovine.
• Vsaka sinhronizacija ponovno prebere celo okno. Committi se lahko pojavijo na privzeti veji dolgo po pisanju, ko se veja združi. Ponovno branje ohranja pravilne seštevke.
• Dolga okna pri zelo velikih repozitorijih lahko udarijo v GitHubove limite. Če prvi uvoz spodleti, poskusi krajše okno zgodovine.

Glej tudi Odpravljanje težav.