Ga naar inhoud

Je postvak in triëren

Deze gids laat zien hoe je het postvak afwerkt: het enige oppervlak dat alles verzamelt wat jou blokkeert of expliciet om jou vraagt — openstaande agentgoedkeuringen, mislukte ticketsynchronisaties en elke pull request waarbij je als reviewer of auteur betrokken bent.

  1. Klik op Postvak in in de sidebar. De badge telt openstaande agentgoedkeuringen, mislukte synchronisaties en open PR’s die op jouw review wachten.
  2. Of druk op ⌘K en voer het navigatiecommando Postvak in uit.
  3. Of maak rechtstreeks een deep link naar /workspaces/<workspace-id>/inbox.

De vermelding in de sidebar toont altijd de live telling, zodat je ziet hoe triagewerk zich opstapelt zonder de pagina te openen.

Scan van boven naar beneden; het postvak is al op urgentie geordend:

  1. De vastgezette strook Vraagt je aandacht staat boven de PR-secties. Elke kaart draagt een ernstchip. Geregistreerde bronnen (een agent die vastzit op een bevestigingsprompt, een ticketsynchronisatie waarvan de leveranciersspiegel verouderd is) geven Geblokkeerd af.
  2. Binnen de strook komt de hoogste ernst eerst; bij een gelijke stand gaat het item dat het langst wacht voor.
  3. Onder de strook worden PR’s gegroepeerd in vaste secties van de review-levenscyclus — Wacht op jouw review, Terug naar jou, Goedgekeurd, Concepten, Wacht op reviewers, Bezig met mergen en recent gemerged, Wacht op de auteur. De bovenste secties zijn wat jou nodig heeft; de rest laat zien waar jouw PR’s staan. Wacht op jouw review bevat ook PR’s die nog om een team vragen waar je deel van uitmaakt, op forges die dat ondersteunen (GitHub laat het team vallen zodra een teamgenoot een review indient).

Een item belandt alleen in het postvak wanneer het iets blokkeert of jou expliciet opvraagt. Een lege strook plus een lege sectielijst toont alleen Je bent helemaal bij wanneer die leegte betrouwbaar is.

Als de werkruimte repo’s op meer dan één codehost heeft, voegt het postvak ze samen tot één stroom — een GitHub-pull request en een Bitbucket-pull request staan in dezelfde sectie, geordend op tijd in plaats van gegroepeerd per leverancier. De meta repo #number in de rij is wat ze onderscheidt.

Of iets van jou is, wordt per forge bepaald, want je bent op elke forge een ander account. Een pull request geldt alleen als van jou, of als een verzoek om jouw review, wanneer hij overeenkomt met je identiteit op de forge waar die repo daadwerkelijk staat.

Een forge die platligt of niet verbonden is, draagt niets bij en laat de rest van het postvak intact — één kapotte verbinding maakt nooit de hele lijst leeg. De lege toestand noemt een voorbehoud in plaats van Je bent helemaal bij wanneer elke forge-login nog niet is bepaald (Kon je GitHub-account niet bevestigen — de tekst noemt nog steeds GitHub), wanneer githubstatus.com een incident meldt, of wanneer een installatie van de GitHub App die gekoppelde repo’s dekt, is opgeschort.

Elke kaart in de strook heeft één vervolgactie:

  1. Als een kaart een openstaande agentbevestiging is, klik dan op Beoordelen — je komt uit in de ruimte van die agent met zijn openstaande bevestiging. Keur daar goed of wijs af (zie Chatten met een agent).
  2. Als een kaart Synchronisatie mislukt zegt voor een leverancier, klik dan op Openen — je komt uit op Instellingen → Werkruimte → Algemeen, waarvan de kaart Synchronisatiestatus de laatste synchronisatie van elke verbinding toont, plus de reeks opeenvolgende fouten en de laatste uitkomst. Alleen de laatste fout per leverancier verschijnt in het postvak, dus een herstelde synchronisatie wist de kaart.
  3. Kaarten verdwijnen vanzelf zodra de onderliggende toestand is opgelost (de agent heeft antwoord gekregen, de synchronisatie herstelt) — er is niets om handmatig weg te klikken.
  1. Druk op f (zonder dat een tekstveld focus heeft) om het filtermenu te openen, of klik op de filterknop in de werkbalk.
  2. Kies een willekeurige combinatie van status, auteur, reviewers, inhoud, repo-eigenaar/naam, datumvensters of snel te reviewen. De facettellingen in het menu tonen op hoeveel postvakitems elke optie past.
  3. Actieve filters verschijnen als chips in de balk boven de lijst; klik op de ✕ van een chip om dat criterium te laten vallen.
  4. Gebruik de linkerrail om tussen secties te springen — elke vermelding toont zijn live telling en de markering volgt je scrollpositie. Klik op een sectiekop om secties die je niet trieert in te klappen (bijvoorbeeld Concepten terwijl je reviews wegwerkt).
  5. Klik op een kolomkop (titel, wijzigingen of bijgewerkt) om elke sectie te sorteren; klik nogmaals op de actieve kolom om de richting om te draaien. De knop voor weergaveopties regelt de zichtbaarheid van concepten, het venster voor recent gemerged, rij-eigenschappen, ordening en groepering (alleen groeperen op auteur verandert de indeling van het postvak).

Filters hier staan los van de PR-wachtrij — het postvak verfijnen verandert nooit de filters van de wachtrij en andersom.

  1. Klik op een willekeurige rij om de PR-detailpagina te openen.
  2. Staat de PR in Wacht op jouw review, review hem dan en dien je beslissing in — zie Een PR reviewen en mergen.
  3. Staat de PR in Terug naar jou (wijzigingen gevraagd of CI mislukt), push dan fixes vanaf je checkout of geef de follow-up aan een agent.
  4. Staat de PR in Goedgekeurd, merge hem dan vanaf de detailpagina.
  5. Wil je een review liever delegeren dan zelf doen, zie Reviewer-agenten starten en de levenscyclus van agent-dispatch.

Zodra de onderliggende toestand verandert (je review komt binnen, de PR wordt gemerged), zet de classificator de PR automatisch in zijn nieuwe sectie.

  1. Druk op ⌘Z om de laatste actie ongedaan te maken, op ⌘⇧Z om hem opnieuw uit te voeren.
  2. Als een tekstveld focus heeft, bewerkt ⌘Z in plaats daarvan de tekst in het veld — klik eerst buiten het veld om een actie op appniveau ongedaan te maken.

Druk op ? (zonder dat een tekstveld focus heeft) om het sneltoetsenoverzicht te openen. Het somt elke binding op die actief is op de huidige route, inclusief de filtersneltoets f van het postvak. De volledige kaart staat in de referentiegids voor sneltoetsen.

  1. Druk waar dan ook op ⌘K om het commandopalet te openen.
  2. Typ Postvak in om naar de pagina te springen, of typ een PR-titel — het palet toont overeenkomende pull requests en opent degene die je kiest.
  3. Voer, terwijl het postvak open is, Link naar deze pagina kopiëren uit om die URL te kopiëren voor het delen. Het commando kopieert de huidige route, dus het is alleen de postvak-URL wanneer je op deze pagina bent.

Het postvak werkt live bij, maar als je vermoedt dat de gegevens verouderd zijn, klik dan op de verversknop in de werkbalk — die forceert onmiddellijk een doorloop aan de serverkant over elke verbonden forge en haalt de overlays voor gemergede en gereviewde items opnieuw op. Het pictogram draait tot elke fetch is afgerond.