website-and-documentation/content/en/docs-old/v1/solution/design/architectural-work-structure.md
Stephan Lo 62999b41d0 feat(docs): restructure documentation with new framework and templates
- 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
2025-11-16 13:32:10 +01:00

1.7 KiB

arbeitsteilung arcihtekur, nach innen und nach aussen

Sebastiano, Stefan, Robert, Patrick, Stephan 25.2.25, 14-15h

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)