openchoreo · shirolk · Aug 29, 2025 · Aug 28, 2025 · Aug 28, 2025 · Aug 28, 2025
diff --git a/blog/2019-05-28-first-blog-post.md b/blog/2019-05-28-first-blog-post.md
diff --git a/blog/2019-05-29-long-blog-post.md b/blog/2019-05-29-long-blog-post.md
diff --git a/blog/2021-08-01-mdx-blog-post.mdx b/blog/2021-08-01-mdx-blog-post.mdx
diff --git a/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg b/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg
diff --git a/blog/2021-08-26-welcome/index.md b/blog/2021-08-26-welcome/index.md
diff --git a/blog/2025-08-26-welcome-to-openchoreo-blog.mdx b/blog/2025-08-26-welcome-to-openchoreo-blog.mdx
@@ -0,0 +1,38 @@
+---
+slug: welcome-to-openchoreo-blog
+title: Welcome to OpenChoreo Blog
+authors: [sameera]
+description: We’re excited to launch the OpenChoreo Blog!
+---
+
+import logo from '../static/img/openchoreo-logo.png';
+
+Welcome to the OpenChoreo Blog, your new home for updates, ideas, and stories from the OpenChoreo open-source community! We’re just getting started, and we’re thrilled to share this journey with you.
+
+On this blog, we plan to post release updates, upcoming features, community adoption stories, and the occasional off-topic stuff (you’ve been warned).
+
+{/* truncate */}
+
+<img src={logo} alt="OpenChoreo Logo" style={{width: 300}} />
+
+In the meantime, we’d love to hear your thoughts on the OpenChoreo logo. What comes to your mind when you see it? Feel free to share your impressions, interpretations, or wild guesses in whatever way you can. We’ll write more about the logo soon.
+
+To wrap things up, here’s a roundup of recent posts, talks, and videos that dive deeper into OpenChoreo or explore related ideas in the platform engineering space:
+- [OpenChoreo GitHub repo](https://github.com/openchoreo/openchoreo)
+- [OpenChoreo Architecture](https://openchoreo.dev/docs/next/overview/architecture/)
+- [Why Companies Fail at Building Internal Developer Platforms (IDPs)](https://www.youtube.com/watch?v=K0ZQ2NmFRMo)
+- [OpenChoreo: An Open Source Blueprint for Internal Developer Platforms](https://www.youtube.com/watch?v=9A-CIye50HY)
+- [Platformless: How Choreo Built a Secure Kubernetes Platform with GitOps](https://itnext.io/platformless-how-choreo-built-a-secure-kubernetes-platform-with-gitops-b7bca909b9f3)
+
+We’re always looking for guest posts, community contributions, and feedback. If you’re building with OpenChoreo or thinking about it, don’t hesitate to reach out.
+
+Until next time — happy hacking, and welcome aboard.
+
+
+
+
+
+
+
+
+
diff --git a/blog/authors.yml b/blog/authors.yml
@@ -1,25 +1,8 @@
-yangshun:
-  name: Yangshun Tay
-  title: Ex-Meta Staff Engineer, Co-founder GreatFrontEnd
-  url: https://linkedin.com/in/yangshun
-  image_url: https://github.com/yangshun.png
+sameera:
+  name: Sameera Jayasoma
+  title: WSO2
+  url: https://github.com/sameerajayasoma
+  image_url: https://github.com/sameerajayasoma.png
   page: true
-  socials:
-    x: yangshunz
-    linkedin: yangshun
-    github: yangshun
-    newsletter: https://www.greatfrontend.com
-
-slorber:
-  name: Sébastien Lorber
-  title: Docusaurus maintainer
-  url: https://sebastienlorber.com
-  image_url: https://github.com/slorber.png
-  page:
-    # customize the url of the author page at /blog/authors/<permalink>
-    permalink: '/all-sebastien-lorber-articles'
-  socials:
-    x: sebastienlorber
-    linkedin: sebastienlorber
-    github: slorber
-    newsletter: https://thisweekinreact.com
+
+
diff --git a/docs/overview/architecture.md → docs/overview/architecture.mdx b/docs/overview/architecture.md → docs/overview/architecture.mdx
@@ -3,11 +3,14 @@ title: Architecture
 description: Explore how OpenChoreo is architected across control, data, CI, and observability planes, and how these components work together to deliver a comprehensive Internal Developer Platform.
 ---
 
-# OpenChoreo Architecture
+import PlatformAPIDiagram from '../resources/openchoreo-platform-abstractions.png';
+import DeveloperAPIDiagram from '../resources/openchoreo-development-abstractions.png';
+import CellRuntimeDiagram from '../resources/openchoreo-cell-runtime-view.png';
 
+# OpenChoreo Architecture
 OpenChoreo is architected as a modular, Kubernetes-native control plane that integrates deeply with other open-source projects to provide a comprehensive, extensible Internal Developer Platform (IDP).
 
-The Control Plane acts as the orchestrator, transforming high-level platform and developer intent into actionable workloads deployed across CI, Data planes, while wiring them into the Observability plane for visibility.
+The Control Plane acts as the orchestrator, transforming high-level platform and developer intent into actionable workloads deployed across Data planes, while wiring them into the Observability plane for visibility.
 
 The diagram below illustrates how these components interact.
 
@@ -37,7 +40,7 @@ The Control Plane is extensible, allowing integration with different backends fo
 ## Developer API
 The Developer API is a set of Kubernetes CRDs designed to simplify cloud-native application development. It provides self-service, low-cognitive-load abstractions so developers don’t have to deal with Kubernetes internals. 
 
-<img src="../resources/openchoreo-development-abstractions.png" alt="Platform API Diagram" width="600"/>
+<img src={DeveloperAPIDiagram} style={{width: 700}} />
 
 These abstractions align with the Domain-Driven Design principles, where projects represent bounded contexts and components represent the individual services or workloads within a domain. Developers use these abstractions to describe the structure and intent of the application in a declarative manner without having to deal with runtime infrastructure details. 
 
@@ -58,7 +61,7 @@ These abstractions align with the Domain-Driven Design principles, where project
 ## Platform API 
 The Platform API enables platform engineers to configure the overall platform topology. These CRDs define organizational boundaries, environment structure, runtime clusters, and automation logic.
 
-<img src="../resources/openchoreo-platform-abstractions.png" alt="Platform API Diagram" width="600"/>
+<img src={PlatformAPIDiagram} style={{width: 700}} />
 
 - **Organization**
   - A logical grouping of users and resources, typically aligned to a company, business unit, or team. 
@@ -81,7 +84,7 @@ To support multi-tenancy, environment isolation, and domain-driven design, the O
 
 In OpenChoreo, we refer to this namespace as a Cell — a secure, isolated, and observable boundary for all components belonging to that project-environment combination. The Cell becomes the unit of deployment, policy enforcement, and observability, aligning with the [cell-based architecture](https://github.com/wso2/reference-architecture/blob/master/reference-architecture-cell-based.md) pattern: a model where individual teams or domains operate independently within well-defined boundaries, while still benefiting from shared infrastructure capabilities.
 
-<img src="../resources/openchoreo-cell-runtime-view.png" alt="Platform API Diagram" width="600"/>
+<img src={CellRuntimeDiagram} style={{width: 700}} />
 
 - **Cell** 
   - A Cell is the runtime reification of a single project in OpenChoreo. It encapsulates all components of a project and controls how they communicate internally and externally through well-defined ingress and egress paths.

diff --git a/docs/overview/what-is-openchoreo.mdx b/docs/overview/what-is-openchoreo.mdx
@@ -23,7 +23,7 @@ This creates gap: **Platform engineers are left to build the real platform** def
 - A **Control Plane** that understands and enforces these APIs with GitOps support
 - A **built-in CI system**
 - An **opinionated Data Plane** with runtime enforcement of design-time semantics 
-- Built-in **Security**, **networking** and **observability** integrations
+- Built-in **security**, **networking** and **observability** integrations
 
 With OpenChoreo, we are bringing the best ideas of [WSO2 Choreo](https://choreo.dev) (an IDP as a Service) to the open-source community. WSO2 Choreo is designed not just to automate software delivery workflows, but to support engineering best practices: enforcing architecture standards, promoting service reuse, and integrating API management and observability.
 
@@ -38,7 +38,7 @@ OpenChoreo is made up of several key components that work together to deliver a
 - **CI Plane** - A built-in CI engine powered by Argo Workflows. It builds the container images, runs tests and publishes artifacts. It is an optional plane. 
 - **Observability Plane** - Out-of-the-box visibility with logs, metrics and traces, using tools like Prometheus, Fluent Bit and OpenSearch. 
 
-Learn more about how these components fit together in the [OpenChoreo Architecture](./architecture.md) section.
+Learn more about how these components fit together in the [OpenChoreo Architecture](./architecture.mdx) section.
 
 ## Current Status
 
@@ -51,7 +51,7 @@ See our [Roadmap](https://github.com/orgs/openchoreo/projects/4) for upcoming fe
 
 Ready to try OpenChoreo? Start here:
 
-1. **[Architecture](./architecture.md)** - Understand the multi-plane architecture
+1. **[Architecture](./architecture.mdx)** - Understand the multi-plane architecture
 2. **[Quick Start Guide](../getting-started/quick-start-guide.mdx)** - Try OpenChoreo in minutes using a Dev Container
 3. **[Installation Guide](../getting-started/single-cluster.mdx)** - Deploy OpenChoreo in your environment
 4. **[Concepts](../concepts/developer-abstractions.md)** - Learn the platform abstractions

diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -99,7 +99,7 @@ const config: Config = {
           position: 'left',
           label: 'Documentation',
         },
-        // {to: '/blog', label: 'Blog', position: 'left'},
+        {to: '/blog', label: 'Blog', position: 'left'},
         {
           type: 'docsVersionDropdown',
           position: 'right',
@@ -158,10 +158,10 @@ const config: Config = {
         {
           title: 'More',
           items: [
-            // {
-            //   label: 'Blog',
-            //   to: '/blog',
-            // },
+            {
+              label: 'Blog',
+              to: '/blog',
+            },
             {
               label: 'GitHub',
               href: 'https://github.com/openchoreo/openchoreo',