Skip to main content

Documentatie-inventaris en voorstel uitstrijking

Datum: 2026-02-01
Doel: Overzicht van losse MD-bestanden en archive; voorstel voor een minder chaotische structuur.


1. Huidige situatie

1.1 Loose MD-bestanden in projectroot (/projects/ohpen-case-2026/)

BestandTypeSuggestie
DEPLOYMENT_SUCCESS.mdStatus/verificatiedocs/internal/verification/
EVIDENCE_AUDIT.mdAuditdocs/internal/audits/
EVIDENCE_AUDIT_EXECUTIVE_SUMMARY.mdAuditdocs/internal/audits/
PRESENTATION_FINAL_POLISH_APPLIED.mdPresentatie-logdocs/internal/presentation/ of archive
PRESENTATION_SECOND_PASS_AUDIT.mdAuditdocs/internal/audits/
PRESENTATION_EDITS_APPLIED.mdLogdocs/internal/presentation/ of archive
PRESENTATION_CONSISTENCY_AUDIT.mdAuditdocs/internal/audits/
TESTING_DOCUMENTATION_INDEX.mdIndex (actief)Blijft in root of → docs/guides/
BLOCKER_MAJOR_FIXES_CHANGELOG.mdChangelogdocs/internal/changelogs/ of archive
CLOSURE_AUDIT_REPORT.mdAuditdocs/internal/audits/
COMPREHENSIVE_CONSISTENCY_AUDIT_REPORT.mdAuditdocs/internal/audits/
CORRELATION_REPLAYABILITY_AUDIT.mdAuditdocs/internal/audits/
COST_SCALE_STRESS_TEST.mdTechnisch ontwerpdocs/technical/ of reference/
DEEP_PAGES_ORPHAN_ANALYSIS.mdAnalysedocs/internal/audits/
DOCUMENTATION_AUDIT_REPORT.mdAuditdocs/internal/audits/
DOCUMENTATION_CLEANUP_REPORT.mdRapportdocs/internal/ of archive
DOCUMENTATION_IMPROVEMENTS_COMPLETE.mdStatusdocs/internal/ of archive
DOCUSAURUS_STRUCTURE_RECOMMENDATION.mdAdviesdocs/internal/ of archive
EDITORIAL_FIXES_VERIFICATION_REPORT.mdVerificatiedocs/internal/verification/
EDITORIAL_NOISE_REDUCTION_AUDIT.mdAuditdocs/internal/audits/
FINAL_AUDIT_REPORT.mdAuditdocs/internal/audits/
FINAL_VERIFICATION_REPORT.mdVerificatiedocs/internal/verification/
INTERNAL_LINKING_AUDIT_REPORT.mdAuditdocs/internal/audits/
INTERNAL_LINKING_FIXES_SUMMARY.mdSamenvattingdocs/internal/audits/
INTERNAL_LINKING_COMPLETE.mdStatusdocs/internal/ of archive
INTERVIEW_DEFENSE_PREP_INTERNAL.mdInterndocs/internal/
LINKING_ANALYSIS_REPORT.mdAnalysedocs/internal/audits/
COMPLETE_LINKING_ANALYSIS.mdAnalysedocs/internal/audits/
MINOR_FIXES_COMPLETION_REPORT.mdStatusdocs/internal/ of archive
STYLE_GUIDE_APPLICATION_AUDIT.mdAuditdocs/internal/audits/
SUBMISSION_CHECKLIST.mdChecklist (actief)Blijft in root of → docs/guides/
SENIOR_POSITIONING_*.md / IMPLEMENTATION_SUMMARY_SENIOR_*Interndocs/internal/
AUDIT_EXECUTIVE_SUMMARY.mdAuditdocs/internal/audits/
POST_FIX_VERIFICATION_REPORT.mdVerificatiedocs/internal/verification/
CONSISTENCY_AUDIT_FINAL_VERIFICATION.mdVerificatiedocs/internal/verification/
ARC42_DOCUSAURUS_AUDIT_REPORT.mdAuditdocs/internal/audits/

Totaal root: ~35+ losse MD-bestanden (veel audits/verificaties/changelogs).


1.2 Loose MD-bestanden in docs/ root

BestandIn Docusaurus?Suggestie
README.md✅ HomeBlijft
CLOSURE_VERIFICATION_REPORT.mddocs/internal/verification/
AUDIT_FOLLOW_UP_VERIFICATION.mddocs/internal/verification/
DATA_MODEL_DESIGN_RATIONALE.md✅ ReferenceBlijft
DIAGRAM_READABILITY_FIX_LIST.mddocs/internal/ of archive
JOURNEY_AUDIT_COMPLETE_CHANGES_LIST.mddocs/internal/audits/
JOURNEY_AUDIT_REPORT.mddocs/internal/audits/
METRICS_DISCOVERY_AND_EXECUTIVE_SIGNAL.mddocs/technical/ of internal
MULTI_ARTIFACT_CONSISTENCY_AUDIT_TRUTH_TABLE.mddocs/internal/audits/
MULTI_ARTIFACT_CONSISTENCY_AUDIT.mddocs/internal/audits/
PARQUET_SCHEMA_SPECIFICATION.md✅ ReferenceBlijft
PEP_CONSISTENCY_AUDIT_REPORT.mddocs/internal/audits/
POLISH_AUDIT_EXHAUSTIVE.mddocs/internal/audits/
POLISH_AUDIT_REPORT_2026_02.mddocs/internal/audits/
POLISH_AUDIT_REPORT.mddocs/internal/audits/
POLISH_DIFF_PLAN_HIRING_PANEL.mddocs/internal/
PRESENTATION_DIAGRAM_AUDIT.mddocs/internal/audits/
PRODUCTION_GRADE_EVALUATION_REPORT.mddocs/internal/ of technical
QUALITY_REQUIREMENTS.md✅ SidebarBlijft
REPO_FIX_PROMPT.mddocs/internal/ of archive
RUNBOOKS.md✅ SidebarBlijft
STAKEHOLDERS.md✅ SidebarBlijft
STYLE_CONSISTENCY_AUDIT.md❌ (excluded)docs/internal/audits/
GLOSSARY.md✅ SidebarBlijft
LICENSE.md-Blijft
LOGICAL_DATA_MODEL_LEDGER_TASK1_TASK3.mddocs/internal/ of reference

Totaal docs-root: ~25 bestanden, waarvan ~10 in sidebar; de rest “loos” of excluded.


1.3 docs/development/archive/ (20 bestanden na uitplaatsing)

Allemaal niet in Docusaurus (exclude: **/docs/development/**).

Uit archive gehaald (actief in gebruik):

  • DIAGRAM_COLOR_STANDARD.md → verplaatst naar docs/development/DIAGRAM_COLOR_STANDARD.md (volledige kleur-/vormrichtlijnen; actief verwezen vanuit DIAGRAM_CONVENTIONS, PROMPT_CHECK_SUBGRAPH_TITLES, STYLE_CONSISTENCY_AUDIT).
CategorieBestanden (nog in archive)
Diagram / MermaidDIAGRAM_COLOR_COMPLIANCE_*.md, DIAGRAM_FIXES_APPLIED.md, DIAGRAM_README.md, DIAGRAM_VERIFICATION_REPORT.md — compliance/verificatie-historie
Stakeholder / emailSTAKEHOLDER_EMAIL_VARIANT_1/2/3.md, STAKEHOLDER_EMAIL_VARIANTS_SUMMARY.md, STAKEHOLDER_VISUAL_REPORT.md
Styling / linkingLINKING_SCHEME.md, STYLING_SYSTEMS_COMPLETE.md, MERMAID_TEXT_ENHANCEMENT_EXAMPLES.md, VISUAL_ENHANCEMENT_PLAN.md — verwijzen naar ../DIAGRAM_COLOR_STANDARD.md
OverigERROR_HANDLING_LAYER_NAMING_ALTERNATIVES.md, MAX_ATTEMPTS_POLICY.md, STREAMLINING_SUMMARY.md, TEAM_OWNERSHIP_DIAGRAM_README.md

Actieve referentie (niet in archive):

  • docs/development/DIAGRAM_CONVENTIONS.md → “Full Reference: docs/development/DIAGRAM_COLOR_STANDARD.md
  • docs/development/PROMPT_CHECK_SUBGRAPH_TITLES.md → verwijst naar docs/development/DIAGRAM_COLOR_STANDARD.md
  • docs/internal/audits/STYLE_CONSISTENCY_AUDIT.md e.a. → noemen docs/development/DIAGRAM_COLOR_STANDARD.md

Conclusie archive: Alleen nog historische/ondersteunende artefacten; actieve diagramstandaard staat in docs/development/DIAGRAM_COLOR_STANDARD.md.


2. Voorstel: uitstrijking

2.1 Principe

  1. Root: Alleen leesbare “entrypoints” (bijv. README.md, eventueel SUBMISSION_CHECKLIST.md, TESTING_DOCUMENTATION_INDEX.md).
  2. docs-root: Alleen wat in Docusaurus/sidebar hoort + README.md, LICENSE.md.
  3. Intern/audit/verificatie: Alles naar docs/internal/ met duidelijke submappen.
  4. Archive: Blijft zoals het is; één README in docs/development/archive/ die uitlegt wat het is en waar het voor dient.

2.2 Nieuwe structuur onder docs/

docs/
├── README.md
├── LICENSE.md
├── GLOSSARY.md
├── STAKEHOLDERS.md
├── RUNBOOKS.md
├── QUALITY_REQUIREMENTS.md
├── DATA_MODEL_DESIGN_RATIONALE.md
├── PARQUET_SCHEMA_SPECIFICATION.md
├── submission/ # ongewijzigd
├── technical/ # ongewijzigd
├── runbooks/
├── adr/
├── reference/ # indien docs/reference bestaat of symlink
├── guides/

└── internal/ # NIEUW – niet in Docusaurus (exclude toevoegen)
├── README.md # Kort: "Interne rapporten, audits, verificaties. Niet gepubliceerd."
├── audits/ # Alle *AUDIT*, *REPORT*, *ANALYSIS*
├── verification/ # Alle *VERIFICATION*, *COMPLETE*, fix reports
├── changelogs/ # Changelogs, blocker fixes
└── presentation/ # Presentatie-audits en -logs (optioneel)

2.3 Verplaatsingen (concreet)

Van projectroot → docs/internal/:

  • audits:
    CLOSURE_AUDIT_REPORT.md, COMPREHENSIVE_CONSISTENCY_*, CORRELATION_*, DOCUMENTATION_AUDIT_*, EVIDENCE_AUDIT*.md, FINAL_AUDIT_*, INTERNAL_LINKING_*, LINKING_ANALYSIS_*, COMPLETE_LINKING_*, PRESENTATION_*_AUDIT*.md, STYLE_GUIDE_APPLICATION_AUDIT.md, AUDIT_EXECUTIVE_SUMMARY.md, ARC42_*, DEEP_PAGES_*, EDITORIAL_NOISE_*, plus van docs-root: CLOSURE_VERIFICATION_*, JOURNEY_*, MULTI_ARTIFACT_*, PEP_*, POLISH_*, PRESENTATION_DIAGRAM_*, STYLE_CONSISTENCY_*, AUDIT_FOLLOW_UP_*, DIAGRAM_READABILITY_*, LOGICAL_DATA_MODEL_*.
  • verification:
    DEPLOYMENT_SUCCESS.md, EDITORIAL_FIXES_VERIFICATION_*, FINAL_VERIFICATION_*, POST_FIX_*, CONSISTENCY_AUDIT_FINAL_*, MINOR_FIXES_*, etc.
  • changelogs:
    BLOCKER_MAJOR_FIXES_CHANGELOG.md.
  • presentation (optioneel):
    PRESENTATION_*_APPLIED.md, PRESENTATION_*_AUDIT.md (als je die apart wilt bewaren).
  • overig internal:
    DOCUMENTATION_CLEANUP_*, DOCUMENTATION_IMPROVEMENTS_*, DOCUSAURUS_STRUCTURE_*, INTERVIEW_DEFENSE_*, SENIOR_POSITIONING_*, REPO_FIX_PROMPT.md, etc.

In root laten (optioneel):

  • README.md
  • SUBMISSION_CHECKLIST.md (of verplaatsen naar docs/guides/)
  • TESTING_DOCUMENTATION_INDEX.md (of naar docs/guides/)

Technisch / reference:

  • COST_SCALE_STRESS_TEST.mddocs/technical/ of reference/ (naar inhoud).
  • METRICS_DISCOVERY_*docs/technical/ of docs/internal/ (naar behoefte).
  • PRODUCTION_GRADE_EVALUATION_REPORT.mddocs/technical/ of docs/internal/.

Docusaurus-config:

  • In docusaurus.config.js onder exclude toevoegen: '**/docs/internal/**', zodat docs/internal/ nooit wordt gebuild.

3. Archive: duidelijker maken

  • Niets verplaatsen uit docs/development/archive/ (verwijzingen vanuit DIAGRAM_CONVENTIONS, PROMPT_CHECK_SUBGRAPH_TITLES, STYLE_CONSISTENCY_AUDIT blijven geldig).
  • Wel toevoegen: docs/development/archive/README.md met:
    • Doel: historische/development-artefacten (diagram-stijlen, stakeholder-varianten, streamlining).
    • Niet in Docusaurus; alleen voor intern gebruik en referentie.
    • Korte index per categorie (diagram, stakeholder, styling) met bestandsnamen.

4. Samenvatting acties

ActiePrioriteit
docs/internal/ aanmaken + docs/internal/README.mdHoog
Loose MD uit projectroot verplaatsen naar docs/internal/audits/, verification/, changelogs/, etc.Hoog
Loose MD uit docs/ root (niet in sidebar) verplaatsen naar docs/internal/Hoog
Docusaurus exclude: **/docs/internal/**Hoog
docs/development/archive/README.md toevoegenMedium
Root: alleen README + eventueel checklist/index; rest naar docs/internal of docs/guidesMedium
Links in bestaande docs die naar verplaatste bestanden wijzen bijwerkenNa verplaatsing

5. Exacte lijst (van → naar)

Alle paden zijn relatief aan de projectroot: projects/ohpen-case-2026/.

5.1 Blijft in projectroot (niet verplaatsen)

Bestand
README.md

5.2 Optioneel in root of naar docs/guides (jij kiest)

VanNaar (indien verplaatsen)
SUBMISSION_CHECKLIST.mddocs/guides/SUBMISSION_CHECKLIST.md
TESTING_DOCUMENTATION_INDEX.mddocs/guides/TESTING_DOCUMENTATION_INDEX.md

5.3 Van projectroot → docs/internal/

docs/internal/audits/

VanNaar
ARC42_DOCUSAURUS_AUDIT_REPORT.mddocs/internal/audits/ARC42_DOCUSAURUS_AUDIT_REPORT.md
AUDIT_EXECUTIVE_SUMMARY.mddocs/internal/audits/AUDIT_EXECUTIVE_SUMMARY.md
CLOSURE_AUDIT_REPORT.mddocs/internal/audits/CLOSURE_AUDIT_REPORT.md
COMPLETE_LINKING_ANALYSIS.mddocs/internal/audits/COMPLETE_LINKING_ANALYSIS.md
COMPREHENSIVE_CONSISTENCY_AUDIT_REPORT.mddocs/internal/audits/COMPREHENSIVE_CONSISTENCY_AUDIT_REPORT.md
CORRELATION_REPLAYABILITY_AUDIT.mddocs/internal/audits/CORRELATION_REPLAYABILITY_AUDIT.md
DEEP_PAGES_ORPHAN_ANALYSIS.mddocs/internal/audits/DEEP_PAGES_ORPHAN_ANALYSIS.md
DOCUMENTATION_AUDIT_REPORT.mddocs/internal/audits/DOCUMENTATION_AUDIT_REPORT.md
EDITORIAL_NOISE_REDUCTION_AUDIT.mddocs/internal/audits/EDITORIAL_NOISE_REDUCTION_AUDIT.md
EVIDENCE_AUDIT.mddocs/internal/audits/EVIDENCE_AUDIT.md
EVIDENCE_AUDIT_EXECUTIVE_SUMMARY.mddocs/internal/audits/EVIDENCE_AUDIT_EXECUTIVE_SUMMARY.md
FINAL_AUDIT_REPORT.mddocs/internal/audits/FINAL_AUDIT_REPORT.md
INTERNAL_LINKING_AUDIT_REPORT.mddocs/internal/audits/INTERNAL_LINKING_AUDIT_REPORT.md
INTERNAL_LINKING_FIXES_SUMMARY.mddocs/internal/audits/INTERNAL_LINKING_FIXES_SUMMARY.md
LINKING_ANALYSIS_REPORT.mddocs/internal/audits/LINKING_ANALYSIS_REPORT.md
PRESENTATION_CONSISTENCY_AUDIT.mddocs/internal/audits/PRESENTATION_CONSISTENCY_AUDIT.md
PRESENTATION_SECOND_PASS_AUDIT.mddocs/internal/audits/PRESENTATION_SECOND_PASS_AUDIT.md
STYLE_GUIDE_APPLICATION_AUDIT.mddocs/internal/audits/STYLE_GUIDE_APPLICATION_AUDIT.md

docs/internal/verification/

VanNaar
CONSISTENCY_AUDIT_FINAL_VERIFICATION.mddocs/internal/verification/CONSISTENCY_AUDIT_FINAL_VERIFICATION.md
DEPLOYMENT_SUCCESS.mddocs/internal/verification/DEPLOYMENT_SUCCESS.md
EDITORIAL_FIXES_VERIFICATION_REPORT.mddocs/internal/verification/EDITORIAL_FIXES_VERIFICATION_REPORT.md
FINAL_VERIFICATION_REPORT.mddocs/internal/verification/FINAL_VERIFICATION_REPORT.md
MINOR_FIXES_COMPLETION_REPORT.mddocs/internal/verification/MINOR_FIXES_COMPLETION_REPORT.md
POST_FIX_VERIFICATION_REPORT.mddocs/internal/verification/POST_FIX_VERIFICATION_REPORT.md

docs/internal/changelogs/

VanNaar
BLOCKER_MAJOR_FIXES_CHANGELOG.mddocs/internal/changelogs/BLOCKER_MAJOR_FIXES_CHANGELOG.md

docs/internal/presentation/

VanNaar
PRESENTATION_EDITS_APPLIED.mddocs/internal/presentation/PRESENTATION_EDITS_APPLIED.md
PRESENTATION_FINAL_POLISH_APPLIED.mddocs/internal/presentation/PRESENTATION_FINAL_POLISH_APPLIED.md

docs/internal/ (overig, geen submap)

VanNaar
DOCUMENTATION_CLEANUP_REPORT.mddocs/internal/DOCUMENTATION_CLEANUP_REPORT.md
DOCUMENTATION_IMPROVEMENTS_COMPLETE.mddocs/internal/DOCUMENTATION_IMPROVEMENTS_COMPLETE.md
DOCUSAURUS_STRUCTURE_RECOMMENDATION.mddocs/internal/DOCUSAURUS_STRUCTURE_RECOMMENDATION.md
IMPLEMENTATION_SUMMARY_SENIOR_POSITIONING.mddocs/internal/IMPLEMENTATION_SUMMARY_SENIOR_POSITIONING.md
INTERNAL_LINKING_COMPLETE.mddocs/internal/INTERNAL_LINKING_COMPLETE.md
INTERVIEW_DEFENSE_PREP_INTERNAL.mddocs/internal/INTERVIEW_DEFENSE_PREP_INTERNAL.md
SENIOR_POSITIONING_COMPLETE.mddocs/internal/SENIOR_POSITIONING_COMPLETE.md
SENIOR_POSITIONING_REVIEW.mddocs/internal/SENIOR_POSITIONING_REVIEW.md

docs/technical/ (technisch ontwerp)

VanNaar
COST_SCALE_STRESS_TEST.mddocs/technical/COST_SCALE_STRESS_TEST.md

5.4 Van docs/ root → docs/internal/

docs/internal/audits/

VanNaar
docs/JOURNEY_AUDIT_COMPLETE_CHANGES_LIST.mddocs/internal/audits/JOURNEY_AUDIT_COMPLETE_CHANGES_LIST.md
docs/JOURNEY_AUDIT_REPORT.mddocs/internal/audits/JOURNEY_AUDIT_REPORT.md
docs/MULTI_ARTIFACT_CONSISTENCY_AUDIT.mddocs/internal/audits/MULTI_ARTIFACT_CONSISTENCY_AUDIT.md
docs/MULTI_ARTIFACT_CONSISTENCY_AUDIT_TRUTH_TABLE.mddocs/internal/audits/MULTI_ARTIFACT_CONSISTENCY_AUDIT_TRUTH_TABLE.md
docs/PEP_CONSISTENCY_AUDIT_REPORT.mddocs/internal/audits/PEP_CONSISTENCY_AUDIT_REPORT.md
docs/POLISH_AUDIT_EXHAUSTIVE.mddocs/internal/audits/POLISH_AUDIT_EXHAUSTIVE.md
docs/POLISH_AUDIT_REPORT.mddocs/internal/audits/POLISH_AUDIT_REPORT.md
docs/POLISH_AUDIT_REPORT_2026_02.mddocs/internal/audits/POLISH_AUDIT_REPORT_2026_02.md
docs/PRESENTATION_DIAGRAM_AUDIT.mddocs/internal/audits/PRESENTATION_DIAGRAM_AUDIT.md
docs/STYLE_CONSISTENCY_AUDIT.mddocs/internal/audits/STYLE_CONSISTENCY_AUDIT.md

docs/internal/verification/

VanNaar
docs/AUDIT_FOLLOW_UP_VERIFICATION.mddocs/internal/verification/AUDIT_FOLLOW_UP_VERIFICATION.md
docs/CLOSURE_VERIFICATION_REPORT.mddocs/internal/verification/CLOSURE_VERIFICATION_REPORT.md

docs/internal/ (overig)

VanNaar
docs/DIAGRAM_READABILITY_FIX_LIST.mddocs/internal/DIAGRAM_READABILITY_FIX_LIST.md
docs/LOGICAL_DATA_MODEL_LEDGER_TASK1_TASK3.mddocs/internal/LOGICAL_DATA_MODEL_LEDGER_TASK1_TASK3.md
docs/POLISH_DIFF_PLAN_HIRING_PANEL.mddocs/internal/POLISH_DIFF_PLAN_HIRING_PANEL.md
docs/PRODUCTION_GRADE_EVALUATION_REPORT.mddocs/internal/PRODUCTION_GRADE_EVALUATION_REPORT.md
docs/REPO_FIX_PROMPT.mddocs/internal/REPO_FIX_PROMPT.md

docs/technical/

VanNaar
docs/METRICS_DISCOVERY_AND_EXECUTIVE_SIGNAL.mddocs/technical/METRICS_DISCOVERY_AND_EXECUTIVE_SIGNAL.md

5.5 Blijft in docs/ root (niet verplaatsen)

BestandReden
docs/README.mdDocusaurus home
docs/LICENSE.mdLicentie
docs/GLOSSARY.mdSidebar
docs/STAKEHOLDERS.mdSidebar
docs/RUNBOOKS.mdSidebar
docs/QUALITY_REQUIREMENTS.mdSidebar
docs/DATA_MODEL_DESIGN_RATIONALE.mdSidebar
docs/PARQUET_SCHEMA_SPECIFICATION.mdSidebar
docs/DOCS_INVENTORY_AND_RESTRUCTURING.mdDit document

5.6 Totaal

ActieAantal
Root → docs/internal/ of docs/technical/38 bestanden
docs/ root → docs/internal/ of docs/technical/18 bestanden
Optioneel root → docs/guides/2 bestanden
Blijft root1 (README.md)
Blijft docs root9

Als je wilt, kan ik de volgende stap uitwerken: een concreet lijstje “van → naar” per bestand (inclusief eventuele docs/reference-structuur) of zie sectie 5 hierboven.


6. Uitgevoerd (2026-02-01)

  • Mappen aangemaakt: docs/internal/, docs/internal/audits/, docs/internal/verification/, docs/internal/changelogs/, docs/internal/presentation/.
  • docs/internal/README.md toegevoegd.
  • Alle verplaatsingen uit sectie 5.3 (root → internal/technical) en 5.4 (docs root → internal/technical) uitgevoerd.
  • Docusaurus exclude uitgebreid met '**/docs/internal/**' in docs-site/docusaurus/docusaurus.config.js.

Verificatie: Root 3 .md (README + SUBMISSION_CHECKLIST + TESTING_DOCUMENTATION_INDEX). Docs root 9 .md. docs/internal: 28 audits, 8 verification, 1 changelog, 2 presentation, 14 in internal root (incl. README). docs/technical: COST_SCALE_STRESS_TEST.md en METRICS_DISCOVERY_AND_EXECUTIVE_SIGNAL.md aanwezig.

© 2026 Stephen AdeiCC BY 4.0