- Archive old docs to docs-old/ for reference - Create new top-down documentation structure: * Platform Overview: purpose, audience, product structure * Components: individual platform components (Forgejo, Kubernetes, Backstage) * Getting Started: onboarding and quick start guides * Operations: deployment, monitoring, troubleshooting * Governance: ADRs, project history, compliance - Add DOCUMENTATION-GUIDE.md with writing guidelines and templates - Add component template (TEMPLATE.md) for consistent documentation - Simplify root README and move technical docs to doc/ folder - Update test configuration: * Exclude legacy content from markdown linting * Relax HTML validation for theme-generated content * Skip link checking for legacy content in test:links * Keep 'task test' clean for technical writers (100% pass) * Add 'task test:full' with comprehensive link checking - Update home page with corrected markdown syntax - Fix internal links in archived content BREAKING CHANGE: Documentation structure changed from flat to hierarchical top-down approach
1.7 KiB
1.7 KiB
arbeitsteilung arcihtekur, nach innen und nach aussen
Sebastiano, Stefan, Robert, Patrick, Stephan 25.2.25, 14-15h
links
montags-call
- Sebasriano im montags-call, inklusive florian, mindestens interim, solange wir keinen architektur-aussenminister haben
workshops
- nach abstimmung mit hasan zu platform workshops
- weitere beteiligung in weiteren workshop-serien to be defined
programm-alignment
- sponsoren finden
- erledigt sich durch die workshop-serien
interne architekten
- robert und patrick steigen ein
- themen-teilung
produkt struktur
edp standalone ipcei edp
architektur themen
stl
produktstruktur application model (cnoe, oam, score, xrd, ...) api backstage (usage scenarios) pipelining 'everything as code', deklaratives deployment, crossplane (bzw. orchestrator)
ggf: identity mgmt
nicht: security monitoring kubernetes internals
robert
pipelining kubernetes-inetrnals api crossplane platforming - erzeugen von ressourcen in 'clouds' (e.g. gcp, und hetzner :-) )
patrick
security identity-mgmt (SSI) EaC und alles andere macht mir auch total spass!
einschätzungen
- ipceicis-pltaform ist wichtigstes teilprojekt (hasan + patrick)
- offener punkt: workload-steuerung, application model (kompatibility mit EDP)
- thema security, siehe ssi vs. oidc
- wir brauchen eigene workshops zum definieren der zusammenarbiets-modi
committements
- patrick und robert nehmen teil an architektur
offen
- sebastian schwaar onboarding? (>=50%) --- robert fragt
- alternative: consulting/support anfallsweise
- hält eine kubernetes einführungs-schulung --> termine sind zu vereinbaren (liegt bei sophie)