docs/.gitignore

@@ -19,3 +19,6 @@ pnpm-debug.log*
 
 # macOS-specific files
 .DS_Store
+
+# IDE specific files
+.vscode

docs/src/content/docs/architecture/adr/000100-repository-structure.mdx

@@ -1,11 +1,11 @@
 ---
-title: "ADR-0001000: Repository Structure"
+title: "ADR-000100: Repository Structure"
 description: "Decision to use a pnpm-based monorepo structure for LUNA Charts."
 ---
 
 * **Status:** Accepted
 * **Date:** 2026-07-12
-* **Last Updated:** 2026-07-17
+* **Last Updated:** 2026-08-31
 * **Decision Makers:** LUNA Charts Maintainers
 
 ---

docs/src/content/docs/architecture/adr/000200-technology-stack.mdx

@@ -1,11 +1,11 @@
 ---
-title: "ADR-0002000: Technology Stack"
+title: "ADR-000200: Technology Stack"
 description: "Selection of the technology stack for LUNA Charts based on the TOGAF architectural principles."
 ---
 
 * **Status:** Accepted
 * **Date:** 2026-07-12
-* **Last Updated:** 2006-07-17
+* **Last Updated:** 2026-07-17
 * **Decision Makers:** LUNA Charts Maintainers
 
 ---
@@ -58,7 +58,7 @@ The following factors influenced the decision:
 | Code Formatting         | Manual Formatting, Prettier                     | **Prettier**       |
 | Static Analysis         | TSLint, ESLint                                  | **ESLint**         |
 | Versioning              | Manual Versioning, Semantic Release, Changesets | **Changesets**     |
-| Continuous Integration  | GitLab CI, Azure Pipelines, GitHub Actions      | **GitHub Actions** |
+| Continuous Integration  | GitLab CI, Azure Pipelines, Gitea Actions       | **Gitea Actions**  |
 
 The selected technologies best support the project's architectural goals while remaining broadly adopted and well documented.
 

docs/src/content/docs/architecture/adr/000300-web-components-as-public-api.mdx

@@ -1,5 +1,5 @@
 ---
-title: "ADR-0003000: Web Components as Public API"
+title: "ADR-000300: Web Components as Public API"
 description: "Decision to make LUNA Charts' public API available exclusively via Web Components."
 ---
 

docs/src/content/docs/getting-started/project-structure.mdx

@@ -17,7 +17,7 @@ luna-charts/
 │
 ├── examples/
 │
-├── .github/
+├── .gitea/
 │
 ├── package.json
 └── pnpm-workspace.yaml

docs/src/content/docs/getting-started/roadmap.mdx

@@ -11,77 +11,86 @@ Instead of implementing features immediately, the project establishes a solid ar
 
 ---
 
-## Current Status
+## Completed Milestones ✅
 
-**Current Phase:** Groundwork
+<details>
-
+  <summary>**Completed:** Groundwork (v0.1.0)</summary>
-The project is currently preparing the technical and organizational foundation for future development.
+  The project is preparing the technical and organizational foundation for future development.
 
 Completed work includes:
 
-- Repository structure
+- **Repository structure:** Standardized layout for code, configurations, and assets. 
-- Development workflow
+- **Development workflow: Definition of branching strategies, commit rules, and review processes. 
-- Architecture documentation (TOGAF ADM)
+- **Architecture documentation (TOGAF ADM):** Architecture framework set up according to the TOGAF standard.
-- Architecture Decision Records (ADRs)
+- **Architecture Decision Records (ADRs 1-5):** System established for transparent documentation of architectural decisions.
-- Project governance
+- **Project governance:** Defined roles, responsibilities, and decision-making processes.
-- Documentation infrastructure
+- **Documentation infrastructure:** "Docs-as-Code" setup integrated into the repository.
 
 At this stage, no production-ready chart components are available.
 
----
+</details>
-
-## Upcoming Milestones
-
-### Foundation
-
-- Create the initial StencilJS library
-- Establish Storybook for component development
-- Configure testing infrastructure
-- Configure CI/CD pipeline
 
 ---
 
-### First Proof of Concept
+## Current Status ⏳
 
-Deliver the first functional chart implementation to validate the technical architecture.
+### Foundation v0.2.0
 
+This milestone focuses on setting up the technical core of the component library. The goal is to build an automated, 
+testable, and documented environment for efficient StencilJS component development.
+
+- **Create the initial StencilJS library:** Initialize the codebase and core configurations for the web component engine.
+- **Establish Storybook for component development:** Set up Storybook as the development environment and isolated playground for component creation.
+- **Configure testing infrastructure:** Configure unit, integration, or visual regression testing frameworks.
+- **Configure CI/CD pipeline:** Automate linting, testing, and initial build checks on every repository push or pull request.
+
+---
+
+## Upcoming Milestones 🚀
+
+### First Proof of Concept v0.3.0
+
+This milestone focuses on validating the core technical and accessibility assumptions of the library through a first 
+working implementation. The goal is to prove that the chosen architecture (SVG rendering, Web Components, accessibility-first 
+approach) actually works in practice before committing to a broader component set.
 Goals include:
 
-- SVG rendering
+- **SVG rendering:** Implement a first chart component using SVG-based rendering.
-- Accessibility validation
+- **Accessibility validation:** Verify WCAG compliance with automated (axe-core) and manual (screen reader) testing.
-- Framework integration
+- **Framework integration:** Confirm the component works correctly when consumed from at 
-- Community feedback
+least one external framework (e.g. React or Vue).
+- **Community feedback:** Share the proof of concept for early feedback before scaling to further components.
 
 ---
 
-### Minimum Viable Product (MVP)
+### Minimum Viable Product (MVP) v1.0.0
-
-Provide the first publicly usable version of LUNA Charts.
 
+This milestone marks the first public-ready release. The goal is a stable, documented, 
+and accessible set of chart components that can be safely adopted by external users.
 The MVP focuses on delivering value rather than completeness.
 
 Expected outcomes include:
 
-- Initial chart collection
+- **Initial chart collection:** Ship a first stable set of chart types built on the validated architecture.
-- Stable public API
+- **Stable public API:** Freeze the public component API surface and document breaking-change policy.
-- Documentation
+- **Documentation:** Complete user-facing documentation (usage guides, API reference, accessibility notes).
-- Example applications
+- **Example applications:** Provide working examples for common framework integrations.
-- Accessibility support
+- **Accessibility support:** Ensure all shipped components meet the project's WCAG target across the full component set.
 
 ---
 
 ### Community Growth
 
-After the MVP, the project will gradually expand.
+With a stable MVP in place, this milestone shifts focus toward expanding the library's reach, 
-
+capabilities, and contributor base.
 Future work may include:
 
-- Additional chart types
+- **Additional chart types:** Expand the component library beyond the initial MVP set.
-- Advanced customization
+- **Advanced customization:** Add theming, styling, and configuration options requested by users.
-- Performance improvements
+- **Performance improvements:** Optimize rendering and bundle size based on real-world usage.
-- Extended framework support
+- **Extended framework support:** Broaden compatibility with additional frameworks and build tools.
-- Community contributions
+- **Community contributions:** Establish a smooth path for external contributors (good-first-issue labeling, contributor docs).
-- Governance evolution
+- **Governance evolution:** Revisit and evolve project governance as the contributor base grows.
 
 ---