From 332ae54012ea615e5ee24b80f1081e0eeaba647b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:21:19 +0000 Subject: [PATCH 1/6] Add platform engineering IDP docs diagram Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/_index.md | 1 + hugo-docs/content/docs/_index.md | 1 + .../docs/platform-engineering/_index.md | 101 ++++++++++++++++++ 3 files changed, 103 insertions(+) create mode 100644 hugo-docs/content/docs/platform-engineering/_index.md diff --git a/hugo-docs/content/_index.md b/hugo-docs/content/_index.md index 8facd0b..67ebe21 100644 --- a/hugo-docs/content/_index.md +++ b/hugo-docs/content/_index.md @@ -80,6 +80,7 @@ python -m cli.devopsos scaffold sre --name my-app --team platform | Guide | Description | |-------|-------------| | [Getting Started]({{< relref "/docs/getting-started" >}}) | Zero to first pipeline in 5 minutes | +| [Platform Engineering IDP]({{< relref "/docs/platform-engineering" >}}) | Conceptual self-service IDP flow from templates to generated automation | | [Process-First Philosophy]({{< relref "/docs/getting-started/process-first" >}}) | What Process-First means, how it maps to DevOps-OS, and AI learning tips | | [Quick Start Reference]({{< relref "/docs/getting-started/quickstart" >}}) | All CLI commands at a glance | | [GitHub Actions]({{< relref "/docs/ci-cd/github-actions" >}}) | Generate GHA workflows | diff --git a/hugo-docs/content/docs/_index.md b/hugo-docs/content/docs/_index.md index d388284..39b24c2 100644 --- a/hugo-docs/content/docs/_index.md +++ b/hugo-docs/content/docs/_index.md @@ -18,6 +18,7 @@ Welcome to the DevOps-OS documentation. Use the sidebar to navigate between sect | Section | What you'll find | |---------|-----------------| | [Getting Started]({{< relref "/docs/getting-started" >}}) | Prerequisites, installation, first pipeline | +| [Platform Engineering IDP]({{< relref "/docs/platform-engineering" >}}) | Conceptual self-service flow from templates to generated automation | | [Quick Start]({{< relref "/docs/getting-started/quickstart" >}}) | All CLI commands with output paths | | [CI/CD Generators]({{< relref "/docs/ci-cd" >}}) | GitHub Actions, GitLab CI, Jenkins | | [GitOps & ArgoCD]({{< relref "/docs/gitops" >}}) | ArgoCD and Flux CD configs | diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md new file mode 100644 index 0000000..fd579ec --- /dev/null +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -0,0 +1,101 @@ +--- +title: "Platform Engineering IDP" +description: "Conceptual platform engineering IDP flow from templates through the UI to generated automation." +weight: 15 +--- + +# Platform Engineering IDP Concept + +DevOps-OS can be used as a lightweight **internal developer platform (IDP)** experience: platform teams publish golden-path templates, and developers consume them through a guided self-service flow. + +--- + +## Conceptual flow + +
+ + Platform engineering IDP conceptual flow + Platform team templates flow into an IDP UI. A developer works from git code commit context, selects templates, chooses automation stages, submits, and receives generated delivery artifacts. + + + Templates + Golden-path CI/CD + GitOps • SRE • DevEnv + + + IDP UI + Self-service catalog + Guardrails + standards + + + Git code commit + Repository context + App or service intent + + + 1. Select template + pipeline, GitOps, SRE, devcontainer + + + 2. Select automation stages + build • test • deploy • monitor + + + 3. Click submit + approve and generate automation + + + Outputs + Generated repo changes + Workflow / YAML / config + Standard delivery stages + PR or commit-ready artifacts + + Platform team publishes + Developer context + Guided self-service steps + + + + + + + + + + + + + + + + + + + + Template → IDP UI → Git code commit → Developer selects templates → Select required automation stages → Click submit + +
+ +--- + +## What the diagram shows + +1. **Platform teams** publish reusable templates into the IDP catalog. +2. The **IDP UI** gives developers a guided entry point with platform guardrails. +3. The flow starts from a **Git repository / code commit context** for the service being onboarded or updated. +4. The developer **selects the required template** and **chooses automation stages** such as build, test, deploy, GitOps, or observability. +5. On **submit**, DevOps-OS generates the standardised delivery artifacts that can be committed or reviewed in Git. + +--- + +## Example automation stages + +| Stage | Typical DevOps-OS output | +|-------|---------------------------| +| Build & Test | [GitHub Actions / GitLab CI / Jenkins workflows]({{< relref "/docs/ci-cd" >}}) | +| Deploy | [ArgoCD or Flux GitOps configuration]({{< relref "/docs/gitops" >}}) | +| Observe | [Prometheus, Grafana, and SLO configuration]({{< relref "/docs/sre" >}}) | +| Developer Environment | [Dev Container configuration]({{< relref "/docs/dev-container" >}}) | + +This makes DevOps-OS a practical way to present **platform engineering standards as a self-service IDP experience**. From 11fefedd1bd9543318315536056e04b4dfa10d7d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:21:54 +0000 Subject: [PATCH 2/6] Polish IDP docs wording Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/docs/platform-engineering/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md index fd579ec..1ab88f9 100644 --- a/hugo-docs/content/docs/platform-engineering/_index.md +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -85,7 +85,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp 2. The **IDP UI** gives developers a guided entry point with platform guardrails. 3. The flow starts from a **Git repository / code commit context** for the service being onboarded or updated. 4. The developer **selects the required template** and **chooses automation stages** such as build, test, deploy, GitOps, or observability. -5. On **submit**, DevOps-OS generates the standardised delivery artifacts that can be committed or reviewed in Git. +5. On **submit**, DevOps-OS generates the standardized delivery artifacts that can be committed or reviewed in Git. --- From ab9db99c490a5d08f2f66329bb0073834743caf6 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:22:31 +0000 Subject: [PATCH 3/6] Align IDP diagram wording Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/docs/platform-engineering/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md index 1ab88f9..57beea9 100644 --- a/hugo-docs/content/docs/platform-engineering/_index.md +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -33,7 +33,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp App or service intent - 1. Select template + 1. Select templates pipeline, GitOps, SRE, devcontainer @@ -84,7 +84,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp 1. **Platform teams** publish reusable templates into the IDP catalog. 2. The **IDP UI** gives developers a guided entry point with platform guardrails. 3. The flow starts from a **Git repository / code commit context** for the service being onboarded or updated. -4. The developer **selects the required template** and **chooses automation stages** such as build, test, deploy, GitOps, or observability. +4. The developer **selects the required templates** and **chooses automation stages** such as build, test, deploy, GitOps, or observability. 5. On **submit**, DevOps-OS generates the standardized delivery artifacts that can be committed or reviewed in Git. --- From ea7cb8ced471683e26780cc7ee5e30a792c5ee91 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:23:03 +0000 Subject: [PATCH 4/6] Complete IDP diagram flow summary Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/docs/platform-engineering/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md index 57beea9..eeadcf0 100644 --- a/hugo-docs/content/docs/platform-engineering/_index.md +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -73,7 +73,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp - Template → IDP UI → Git code commit → Developer selects templates → Select required automation stages → Click submit + Templates → IDP UI → Git code commit → Developer selects templates → Select required automation stages → Click submit → Outputs From a8b33e25fba48f5734604f56d3472a7047c79ea5 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:23:39 +0000 Subject: [PATCH 5/6] Standardize IDP footer labels Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/docs/platform-engineering/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md index eeadcf0..f26a845 100644 --- a/hugo-docs/content/docs/platform-engineering/_index.md +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -73,7 +73,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp - Templates → IDP UI → Git code commit → Developer selects templates → Select required automation stages → Click submit → Outputs + Templates → IDP UI → Git code commit → Select templates → Select automation stages → Submit → Outputs From dd486f812983392158fea36255f8c29a4508f535 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:24:15 +0000 Subject: [PATCH 6/6] Refine IDP diagram labels Agent-Logs-Url: https://github.com/cloudengine-labs/devops_os/sessions/6d047d9b-b5a2-4e90-ab9a-8b8cce978bbc Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com> --- hugo-docs/content/docs/platform-engineering/_index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/hugo-docs/content/docs/platform-engineering/_index.md b/hugo-docs/content/docs/platform-engineering/_index.md index f26a845..75b81fb 100644 --- a/hugo-docs/content/docs/platform-engineering/_index.md +++ b/hugo-docs/content/docs/platform-engineering/_index.md @@ -14,7 +14,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp
- Platform engineering IDP conceptual flow + Platform Engineering IDP conceptual flow Platform team templates flow into an IDP UI. A developer works from git code commit context, selects templates, chooses automation stages, submits, and receives generated delivery artifacts. @@ -28,7 +28,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp Guardrails + standards - Git code commit + Git repo / commit Repository context App or service intent @@ -73,7 +73,7 @@ DevOps-OS can be used as a lightweight **internal developer platform (IDP)** exp - Templates → IDP UI → Git code commit → Select templates → Select automation stages → Submit → Outputs + Templates → IDP UI → Git repo / commit → Select templates → Select automation stages → Submit → Outputs