Een brag document is een doorlopende lijst van wat je op je werk hebt gedaan, bijgehouden door jou, in je eigen woorden, aangevuld terwijl de details nog vers zijn. Het is geen cv en geen statusrapport: een cv schrijf je voor vreemden en comprimeert alles, een statusrapport gaat over deze week. Een brag document bestaat zodat het antwoord op ‘wat heb je de afgelopen zes of twaalf maanden bereikt’ wordt opgehaald in plaats van gereconstrueerd.
Waar de term vandaan komt
De uitdrukking werd bekend door programmeur Julia Evans in een bericht uit 2019, ‘Get your work recognized: write a brag document’, met een eenvoudig argument: je leidinggevende kan zich jouw werk niet herinneren in het detail waarin jij dat kunt, en dat verwachten is niet redelijk. Het document dicht dat gat zonder op andermans geheugen te leunen.
De praktijk is ouder dan de naam — beoordelingen beloonden altijd al wie bewijs bewaarde — maar de naamgeving deed ertoe, want die maakte er iets van dat je een collega kunt aanraden zonder dat het klinkt als zelfpromotie.
Wat erin hoort
De meeste mensen noemen alleen opgeleverde functionaliteit en vragen zich dan af waarom het document mager oogt. De categorieën hieronder vallen stelselmatig weg en zijn meestal het sterkste materiaal in een beoordelingsgesprek.
- Werk dat is opgeleverd, met data en één meetbaar resultaat per stuk.
- Werk dat geen oplevering was: codereviews, incidentafhandeling, piketweken, sollicitatiegesprekken die je voerde, documentatie die niemand had opgedragen.
- Begeleiding en vlottrekken — wie je hielp, waarmee, en wat er daarna voor die persoon veranderde.
- Beslissingen waarop je invloed had, inclusief die waarbij het argument je bijdrage was en het resultaat van iemand anders.
- Dingen die mislukten, wat je daarna veranderde en wat je anders zou doen. Deze sectie voorkomt dat het document leest als reclame.
- Vaardigheden en context die je oppikte: een systeem dat nu van jou is, een domein waarover men nu jou kan bevragen.
Een uitgewerkt voorbeeld
Het verschil tussen een bruikbare en een nutteloze regel zit volledig in de concreetheid. Twee versies van hetzelfde halfjaar:
- Zwak: ‘De importpijplijn verbeterd. Geholpen bij het inwerken van nieuwe mensen. Bijgedragen aan de roadmap.’
- Sterk: ‘Retry-afhandeling van de import herschreven (jan–feb). Stille storingen gingen van ongeveer één per week naar nul in de twee maanden erna; storingen verschijnen nu in het queue-dashboard, dus ops hoort er niet meer van via klantmeldingen. PR 2214.’
- Sterk: ‘Twee engineers ingewerkt in maart en april — de handleiding voor het opzetten van de omgeving geschreven die ze allebei gebruikten; tijd tot eerste commit ging van ongeveer een week naar twee dagen.’
- Sterk: ‘In de designreview van februari beargumenteerd tegen de multiregio-uitrol; we stelden hem uit en leverden in plaats daarvan de queue-fix. In juni werd de uitrol om dezelfde redenen versmald.’
Waarom de timing van beoordelingen tegen je werkt
Een beoordeling beslaat zes of twaalf maanden. Het scherpste beeld van de beoordelaar beslaat de laatste weken, want zo werkt aandacht bij iedereen, ook bij goede leidinggevenden. Werk uit maand twee komt al vervaagd het gesprek binnen, en werk gedaan door iemand die vertrokken is, aan een project dat geschrapt werd, komt misschien helemaal niet aan.
Er is een tweede, mechanischer probleem: beoordelaars wisselen. Een leidinggevende die in april begon kan januari niet uit het geheugen beoordelen, alleen uit sporen — en de sporen die er zijn, zijn tickets en agenda-items, die overleggen en afgerond werk oververtegenwoordigen en alles wat moeilijk was ondervertegenwoordigen.
Dit is een waarneming over hoe beoordelingen verlopen, geen onderzoeksresultaat, en zo moet het ook behandeld worden. Het is wel makkelijk te toetsen aan je eigen laatste beoordeling, en dat is hier de enige toets die telt.
Hoe je het vult zonder weer een wekelijks ritueel
Niemand houdt een tweede document vol. De realistische versie is niets extra's schrijven en het brag document samenstellen uit materiaal dat je toch al produceert: gedateerde notities over wat er die dag veranderde, berichten waarin je een beslissing uitlegde, en aantekeningen na een incident.
Dat werkt als het ruwe materiaal via beschrijving op te halen is in plaats van via locatie: vragen ‘wat heb ik aan de importpijplijn gedaan’ en de zes notities krijgen die hem noemen, zonder dat je in januari wist dat ze in december zouden tellen. Een half jaar zo samenstellen is twintig minuten werk. Het uit de agenda reconstrueren is een middag, en het klopt niet.
Wat een brag document niet doet
Het vervangt niet dat werk zichtbaar is terwijl het gebeurt. Een document dat bij de beoordeling zes maanden onzichtbare bijdrage moet uitleggen is een zwakkere positie dan het in maart gezegd hebben, en geen hoeveelheid detail redt dat.
Het hangt ook af van de cultuur. In sommige organisaties leest aankomen met een schriftelijk overzicht als voorbereiding, in andere als lobbyen. De versie die overal goed valt is bewijs in plaats van bijvoeglijke naamwoorden: getallen, data en namen, met het oordeel aan de lezer. En getallen zonder uitgangswaarde zijn ruis: ‘fouten met 60% teruggebracht’ betekent niets zonder wat het was, over welke periode en hoe gemeten. Ten slotte verschuift niets hiervan een salarisschaal of een vacaturestop. Een brag document wint de discussies die echt over bewijs gaan — dat zijn er minder dan het voelt, maar niet nul.
Houd het doorlopend bij in plaats van het bij de beoordeling te schrijven, en maak elke regel concreet genoeg om te controleren: wat er veranderde, wanneer, voor wie en hoeveel ten opzichte van welke uitgangswaarde. Neem de onopvallende categorieën mee — reviews, piket, begeleiding, het gewonnen argument in een designreview: niemand anders legt die vast.