Commit graph

6 commits

Author SHA1 Message Date
a0fb081d80 docs(governance): completely revised governance documentation based on confluence and old edp-doc content analysis
All checks were successful
ci / build (push) Successful in 54s
2025-12-19 15:01:21 +01:00
ca53ac2250 refactor(forgejo): restructured and distributed the content to governance and GARM. Closes https://jira.telekom-mms.com/browse/IPCEICIS-6731
Some checks failed
Hugo Site Tests / test (push) Failing after 1s
ci / build (push) Successful in 54s
2025-11-26 23:57:58 +01:00
d3d9908671 doc(stacks): added governance documentation frame according to IPCEICIS-6737
Some checks failed
Hugo Site Tests / test (push) Failing after 1s
ci / build (push) Successful in 54s
2025-11-17 20:05:12 +01:00
f0ca9bbce2 feat(doc-structure): documentation structure ready for team development or writing resp.
Some checks failed
Hugo Site Tests / test (push) Failing after 1s
ci / build (push) Successful in 53s
2025-11-16 23:10:11 +01:00
82d424aeca fix(docs): remove Backstage component and add editorial headers
- Remove Backstage component page (not in product structure)
- Add editorial status alert to all draft pages with:
  * Jira ticket reference placeholder
  * Assignee field
  * Draft status indicator
  * Last updated date
  * TODO checklist for completion
- Update component template with editorial header
- Use Docsy alert shortcode (warning style) for professional appearance
2025-11-16 13:42:58 +01:00
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