Timeline-visningen i GitHub Projects viser oppgavene langs en tidsakse, men tegner ikke hvilke oppgaver som venter på hverandre. Figurene på denne siden gjør det. De lages automatisk fra brettene hver time, og oppdateres på docs kort tid etter. Et fast skript lager dem etter reglene på denne siden. Feiler en kjøring, står den forrige figuren til feilen er rettet, og datoen under figuren viser når den ble laget. Se Planlagte kjøringer.
Klikk på en tittel, en stolpe eller en pil for å se oppgaven i et vindu over figuren. Vinduet flyttes i tittellinjen og endres i størrelse fra hjørnet nede til høyre. Lenker til andre oppgaver inne i vinduet åpnes i det samme vinduet. Klikk et sted utenfor vinduet som ikke er en lenke, trykk Esc eller klikk × for å lukke det. Ctrl-klikk åpner oppgaven på GitHub i stedet. Hold musa over for å se status, datoer og avhengigheter. Figuren vises i full størrelse i en ramme som kan rulles sidelengs og på høyden. Verktøylinja over figuren zoomer ut og inn (− og +), tilbake til full størrelse (100 %) eller slik at hele bredden får plass (Tilpass bredden). Ctrl + musehjul over figuren zoomer bare figuren. Figuren kan også dras med musa (håndmarkør) i alle retninger. Et klikk uten å dra åpner oppgaven som før. «Åpne figuren i nytt vindu» viser figuren alene, der den kan lagres eller kopieres.
Linja Vis under verktøylinja velger hvilke oppgaver som vises: Alle, Aktive (åpne), Forsinkede (sen start, passert frist eller prognose etter fristen), Ferdige eller Avbrutte (lukket uten å bli gjort). En forelder vises når den selv eller en av sub-issuene passer, så sammenhengen ikke forsvinner. Er du logget inn på docs, finnes også knappen Mine oppgaver. Den markerer med gul bakgrunn oppgavene der du er Responsible eller assignee, uansett hvilket utvalg som vises. Valgene gjelder bare til siden lastes på nytt.
Vinduet henter oppgaven fra GitHub. Uten innlogging tillater GitHub omtrent 60 oppslag i timen. Er grensen nådd, vises en lenke til GitHub i stedet, og innlogging hever grensen.
Eksemplene under viser typiske situasjoner, med noen få oppgaver hver. Tegnforklaringen under hver figur viser bare det som finnes i den figuren. Eksemplene ligger på brettet «[EXAMPLE] Timeline». De er ikke oppgaver, og ligger i et eget repo, solution-task-management-examples. Hver situasjon har sin merkelapp, og et eksempel kan være med i flere. Datoene flyttes automatisk hver uke, så eksemplene alltid ligger rundt dagens dato. Derfor viser eksemplene Start date og Due date som det som har skjedd, ikke historikken. Se Eksempler i dokumentasjonen.
Enkel plan
A er fullført (✓). L pågår: den mørke delen er det som er gjort fram til i dag, og den lyse delen er resten av planen fram til fristen. M er ikke startet og venter på L (⛔). Pila går fra L til M, og ringen på pila viser at avhengigheten er beskrevet i M.
M, N og O venter alle på L. Hold musa over en pil for å se slakken. M starter arbeidsdagen etter at L slutter, uten slakk. N har en uke slakk, men avhengigheten er ikke beskrevet, så pila har ingen ring. O skal starte før L er ferdig. Pila er rød fordi planen ikke henger sammen, og prognosen (lys rød) viser når O kan bli ferdig hvis den starter etter L.
B skulle vært ferdig fredag forrige uke, og er rød fra fristen. D skulle startet samme fredag (gul kant og strek), men venter fortsatt på B og C. Når C er ferdig, rekker ikke D fristen sin. E venter på D, og blir derfor også sen, selv om fristen til E ikke er nådd.
F og G har verken Start date eller Due date, så de plasseres etter oppgavene de venter på: G etter B og F etter E. Stolpene er stiplet fordi datoene er beregnet. G har Duration 3. F har ingen varighet og antas å ta én uke, og det står under figuren. B er forsinket, og derfor flyttes også G.
Mangler startdatoen, regnes den bakover fra fristen med varigheten (stiplet stolpe). I har ingen avhengigheter, men startdatoen som er regnet ut, er passert (gul), og i dag pluss varigheten går forbi fristen, så prognosen er rød. H venter på C. For å rekke fristen måtte H startet før C er ferdig, så pila er rød, og tidligste start etter C pluss varigheten går forbi fristen.
K har tre sub-issues: K1 er ferdig, K2 er ikke startet og har passert fristen, og K3 pågår, men venter på K2. K viser framdriften 1/3, og klammen har rød kant fordi K2 er forsinket. Hullet i den mørke delen er dagene mellom K1 og K3 da ingen av dem var i arbeid. Klikk ▾ foran K for å folde sub-issuene inn, og ▸ for å folde dem ut igjen. K3 har Responsible satt, så den får gul bakgrunn med Mine oppgaver for den som har det brukernavnet.
Stolpe: fra start til slutt. Fargen viser status på brettet. Grå med strek over tittelen betyr at oppgaven er lukket: ✓ foran tittelen betyr fullført, og ✕ med skravert stolpe betyr lukket uten å bli gjort (i GitHub: «Close as not planned» eller duplikat).
Mørk del: det som har skjedd, fra oppgaven ble flyttet til In progress til den ble lukket, eller til i dag hvis den pågår.
Lys stolpe med kant: både start og slutt er satt (Start date og Due date) eller har skjedd.
Stiplet stolpe: minst én av datoene er beregnet, se under.
Gul kant og gul strek under stolpen: sen start. Oppgaven skulle vært startet og er ikke det. Streken går fra startdatoen til i dag.
Rødt etter fristen: sen slutt. Stolpen forlenges forbi fristen, og delen etter fristen er rød. Helt rød er tiden fra fristen til i dag, når fristen er passert uten at oppgaven er ferdig. Lys rød er prognosen: når oppgaven kan bli ferdig hvis den starter i dag, eller når oppgavene den venter på er ferdige, og varer like lenge som planlagt. Varigheten er Duration, ellers lengden fra Start date til Due date. En forsinkelse forplanter seg derfor: blir én oppgave sen, kan oppgavene som venter på den, bli røde før fristen deres er nådd.
Bare datoer noen har satt, gir gult og rødt: Start date, Due date, eller en dato regnet med Duration. En antatt varighet gir aldri gult eller rødt.
Pil: oppgaven pila peker på, venter på oppgaven pila kommer fra.
Rød pil: oppgaven det ventes på, slutter etter at den ventende skal starte. Planen henger ikke sammen.
Hold musa over en pil: hvorfor oppgaven venter, slakk eller overlapp i arbeidsdager, og hvem som koblet oppgavene og når. Klikk på pila for å se avhengigheten og oppgaven som venter i vinduet.
Ring på pila: avhengigheten er beskrevet. Uten ring står det bare at den mangler beskrivelse.
⚠ under figuren: en oppgave beskriver en avhengighet som ikke er koblet i GitHub.
⛔ foran tittelen: oppgaven venter fortsatt på en åpen oppgave.
Gul bakgrunn: oppgaven er din, når du har valgt Mine oppgaver (bare når du er logget inn på docs).
Tegnforklaringen under figuren viser bare det som finnes i figuren.
Rød loddrett strek: dagens dato.
Sub-issues: står innrykket under forelderen. Forelderen har en klamme fra første start til siste slutt blant sub-issuene på brettet, med prognosen medregnet, og framdriften etter nummeret, for eksempel «#11 · 1/3» (ferdige av alle sub-issuene, også dem på andre brett). Fargen på klammen er forelderens status på brettet. Den mørke delen er det som har skjedd, som på stolpene: periodene der minst én sub-issue var i arbeid (fra In progress til ferdig, eller til i dag). Et lyst hull betyr at ingen av sub-issuene var i arbeid da. Rød kant betyr at minst én sub-issue er forsinket, og den synes også når sub-issuene er foldet inn. En lukket forelder har grå klamme med ✓ når den er fullført, og skravert klamme med ✕ når den er lukket uten å bli gjort. Statusen på forelderen settes for hånd og følger ikke sub-issuene automatisk. ▾ foran tittelen folder sub-issuene inn, ▸ folder dem ut igjen. Pilene til og fra sub-issues som er foldet inn, skjules.
Hvor datoene kommer fra
Alle oppgavene på brettet er med. Start og slutt finnes hver for seg, i denne rekkefølgen:
Det som har skjedd. Start er første gang oppgaven ble flyttet til In progress (eller In review) på brettet. Slutt er når oppgaven ble lukket eller flyttet til Done. GitHub registrerer dette selv.
Satt dato: Start date og Due date på brettet.
Beregnet fra varigheten: finnes bare den ene datoen, regnes den andre ut med feltet Duration (arbeidsdager).
Beregnet fra avhengighetene: mangler start, starter oppgaven arbeidsdagen etter at den siste oppgaven den venter på, slutter. Den starter likevel ikke før i dag. Venter den ikke på noe, starter den i dag.
Mangler Duration, antas én uke (fem arbeidsdager). Antallet slike oppgaver står under figuren. Pågår en oppgave lenger enn planlagt, forlenges stolpen til i dag. Hold musa over stolpen for å se datoene og hvor de kommer fra.
Planlagte og faktiske datoer har ikke egne felt. Det som har skjedd, ligger i historikken i GitHub.
Slik får en oppgave riktig plass i figuren
Sett Start date og Due date på brettet, eller én av dem og Duration. Uten noen av dem plasseres oppgaven etter oppgavene den venter på.
Flytt kortet til In progress når arbeidet begynner, og lukk oppgaven når den er ferdig.
Venter oppgaven på en annen oppgave: åpne issuet, finn Relationships i høyremargen og velg Mark as blocked by. Velg oppgaven det ventes på. Den kan ligge i et annet repo.
Skriv hvorfor oppgaven venter under overskriften Avhengigheter i issuet, én linje per oppgave, for eksempel «- #35: trenger juridisk avklaring av samtykke». Task-skjemaet har et eget felt for det. Er oppgaven i et annet repo, skriv for eksempel samt-x/samt-bu-pilot-6#12, med samt-x/ foran, ellers blir det ingen lenke. Selve koblingen er alltid den i steg 3. Teksten beskriver den bare. Se Konvensjoner.
Deler du en oppgave i mindre oppgaver, gjør dem til sub-issues: åpne forelderen, velg Create sub-issue eller Add existing issue nederst i beskrivelsen. Sub-issuene må ligge på samme brett for å vises under forelderen i figuren.
Avhengigheter kan også søkes fram på GitHub med is:blocked, is:blocking og blocked-by:.
Venter oppgaven på noe utenfor GitHub, brukes merkelappen blocked i stedet. Den gir ingen pil. Se Blokkert i Konvensjoner.