User Tools

Site Tools


resources:structuur

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
resources:structuur [2026/10/20 14:28] – created - external edit 127.0.0.1resources:structuur [2026/10/23 22:09] (current) – external edit 127.0.0.1
Line 3: Line 3:
   * **Wat**: de afspraken voor het opzetten en bijhouden van de homelab-documentatie in deze wiki.   * **Wat**: de afspraken voor het opzetten en bijhouden van de homelab-documentatie in deze wiki.
   * **Doel**: elke pagina volgt dezelfde opzet, zodat configuraties en de afwegingen erachter terug te vinden zijn zonder overdocumentatie.   * **Doel**: elke pagina volgt dezelfde opzet, zodat configuraties en de afwegingen erachter terug te vinden zijn zonder overdocumentatie.
-  * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}}+  * **[[resources:metadata:tags:status|Status]]**: {{tag>vastgesteld}}
  
 ===== Uitgangspunten ===== ===== Uitgangspunten =====
Line 19: Line 19:
 | **Device** | Hardware, plaatsing, beheer | Services die erop draaien (komen via backlinks) | | **Device** | Hardware, plaatsing, beheer | Services die erop draaien (komen via backlinks) |
 | **Standaard** | Baseline voor de inrichting van het homelab: netwerk, backups, namen | Specifieke configuraties van een device of service | | **Standaard** | Baseline voor de inrichting van het homelab: netwerk, backups, namen | Specifieke configuraties van een device of service |
 +| **Les** | Hoe iets werkt of hoe je iets aanpakt, rond één punt | Regels, het waarom en de huidige staat: daarvoor verwijst hij naar de standaard, het besluit of de service |
  
 ===== Opmaak ===== ===== Opmaak =====
Line 60: Line 61:
   * **Besluit**: context, overwogen opties inclusief afgewezen, besluit, gevolgen, betrokken pagina's, bronnen (indien relevant).   * **Besluit**: context, overwogen opties inclusief afgewezen, besluit, gevolgen, betrokken pagina's, bronnen (indien relevant).
   * **Standaard**: regel, toepassingsgebied, voorbeeld.   * **Standaard**: regel, toepassingsgebied, voorbeeld.
 +  * **Les**: Reden, Gebruik bij, Geldt voor en Gecontroleerd ingevuld; stappen doorlopen (of met reden gemarkeerd als niet doorlopen); verwijst naar de feiten in plaats van ze te herhalen.
  
 ===== Besluiten ===== ===== Besluiten =====
Line 65: Line 67:
   * De betrokken pagina's staan op één regel: "Betreft: ...".   * De betrokken pagina's staan op één regel: "Betreft: ...".
   * Een besluit heeft geen status "voorgesteld".   * Een besluit heeft geen status "voorgesteld".
 +
 +===== Lessen =====
 +  * Een les legt uit hoe iets werkt of hoe je iets aanpakt, rond één punt. Hij komt in de wiki op verzoek van de eigenaar, niet automatisch na elke chat.
 +  * Een les beschrijft een standaardwijziging (naar ITIL): terugkerend, laag risico, vooraf doordacht. Hij is de moeite waard als minstens één geldt: de actie komt regelmatig terug, het uitvoeren is niet vanzelfsprekend, of een leermoment moet worden geborgd voor een situatie die zich kan herhalen. Vervalt de reden, dan gaat de les naar ''archief''.
 +  * Opbouw: Wat, Doel, Reden, Gebruik bij, Geldt voor, Gecontroleerd, Betreft, status en thematags, daarna Uitgangspunt, Stappen of uitleg, Controle en Bronnen.
 +  * Een les herhaalt geen feiten (poorten, profielen, instellingen). Die staan in de standaard, het besluit of de service waarnaar de les verwijst.
 +  * **Gecontroleerd** noemt de datum en hoe: de stappen doorlopen, of alleen tegen de wiki gelezen. Een stap die niet is doorlopen, zegt dat.
 +  * Een les blijft actueel via de thematags: de lessen staan in de paginalijst van de tag. Wijzig je iets waarvoor een tag geldt, loop dan ook de lessen met die tag na en werk //Gecontroleerd// bij. Past een les niet meer, zet hem dan op ''verouderd''.
  
resources/structuur.1792499292.txt.gz · Last modified: by 127.0.0.1