website-and-documentation/content/en/docs/components/_index.md
Stephan Lo 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

87 lines
2.6 KiB
Markdown

---
title: "Components"
linkTitle: "Components"
weight: 2
description: >
Overview of EDP platform components and their integration.
---
{{% alert title="Draft" color="warning" %}}
**Editorial Status**: This page is currently being developed.
* **Jira Ticket**: TBD
* **Assignee**: Team
* **Status**: Draft - Overview and template created
* **Last Updated**: 2025-11-16
* **TODO**:
* [ ] Document each component based on product structure
* [ ] Add component maturity levels
* [ ] Include integration diagrams
{{% /alert %}}
## Component Overview
The Edge Developer Platform consists of multiple integrated components. Each component serves specific purposes in the overall platform architecture.
This section provides detailed documentation for each component, including:
* Description and purpose
* Key features and capabilities
* Repository links and resources
* Usage instructions and examples
* Integration points with other components
## Core Components
### Source Code Management
**Forgejo**: Self-hosted Git service with repository management, issue tracking, and collaboration features.
**GitLab**: Enterprise-grade Git repository management with CI/CD integration.
### Container Orchestration
**Kubernetes**: Container orchestration platform for deploying and managing containerized applications.
### CI/CD & Automation
**Woodpecker**: Lightweight CI/CD server with pipeline automation.
**GARM**: GitHub Actions-compatible runner manager for self-hosted environments.
**ArgoCD**: GitOps continuous delivery tool for Kubernetes.
### Developer Portal
**Backstage**: Developer portal providing unified interface for platform services, documentation, and tooling.
### Observability
**VictoriaMetrics**: Time-series database for metrics storage and querying.
**Prometheus**: Metrics collection and alerting.
**Grafana**: Visualization and dashboards for metrics and logs.
### Infrastructure as Code
**Terraform**: Infrastructure provisioning and management.
**Crossplane**: Kubernetes-native infrastructure management.
## Component Status
Each component page includes current status and maturity level. Check individual component documentation for detailed information.
## Template for Component Documentation
When documenting a component, include:
1. **Overview**: Brief description and purpose
2. **Key Features**: Main capabilities and use cases
3. **Architecture**: How it fits into EDP
4. **Getting Started**: Quick start guide
5. **Usage Examples**: Common scenarios and patterns
6. **Repository**: Link to source code and additional resources
7. **Integration**: Connection points with other components
8. **Status**: Current maturity level