Werkmethode Kroescontrol
Omdat we voor klanten veelal in klantsystemen werken, gaat deze sectie vooral om hoe wij onze mensen laten samenwerken, en als basis voor onze interne documentatie.
We hebben vele systemen achter slot en grendel staan, maar hier in de publieke sectie is er ruimte voor onze eigen openheid in hoe wij samenwerken.
Belangrijkste punten
- Open Source mentaliteit: We geloven in openheid en transparantie, zowel intern als extern
- Documentatie gedreven: We leggen processen en kennis zorgvuldig vast
- Toegankelijkheid: Informatie is beschikbaar voor wie het nodig heeft, op het juiste moment
- Continu verbeteren: We evalueren en optimaliseren voortdurend onze werkwijzen
Gedetailleerde informatie
Documentatie als basis
Onze documentatie vormt het fundament van onze organisatie. We hanteren hierbij een aantal belangrijke principes:
- Open by default: Zoveel mogelijk documentatie is openbaar toegankelijk
- Beveiligd indien nodig: Gevoelige informatie wordt selectief beveiligd
- Versiecontrole: Alle documentatie valt onder Git versiebeheer
- Community-gedreven: Verbeteringen kunnen door iedereen worden voorgesteld
Toegangsniveaus
We werken met verschillende toegangsniveaus voor onze documentatie:
| Toegangsniveau | Beschrijving | Toegangsmethode |
|---|---|---|
| Publiek | Algemene informatie, werken bij Kroescontrol, kennismaking | Openbare website - geen login vereist |
| Intern | Arbeidsvoorwaarden, budgetten, tools en processen | GitHub login + git-crypt voor repository toegang |
| Operationeel | Operationele processen, planning, resource management | GitHub team: kroescontrol-operation |
| Financieel | Financiële procedures, boekhouding, facturatie | GitHub team: kroescontrol-finance |
Technische infrastructuur
Onze documentatie is gebaseerd op:
- Fumadocs: Moderne documentatie-tool gebaseerd op Next.js
- Markdown: Eenvoudig te schrijven en te onderhouden
- GitHub: Voor versiebeheer en samenwerking
- Git-crypt: Voor selectieve versleuteling van gevoelige content
Toekomstige ontwikkelingen
Onze werkmethode blijft evolueren. Enkele geplande verbeteringen:
- Uitgebreider zoeksysteem met contextgevoelige resultaten
- Verbeterde integratie met kennismanagementsystemen
- Automatische vertaling van documentatie
- Uitgebreidere metrics en analyses van documentatiegebruik
Veelgestelde vragen
Hoe wordt bepaald wat publiek versus intern is?
We hanteren het principe “open tenzij”. Documentatie is standaard publiek, tenzij er goede redenen zijn om het intern te houden (zoals privacy, bedrijfsgevoelige informatie, of specifieke interne processen).
Waar vind ik meer informatie over de technische implementatie?
Voor gedetailleerde technische informatie over Git-crypt en repository toegang, neem contact op met je leidinggevende of het IT-team.