diff --git a/docs/kusion/1-what-is-kusion/1-overview.md b/docs/kusion/1-what-is-kusion/1-overview.md index 7141aeee..08be1aca 100644 --- a/docs/kusion/1-what-is-kusion/1-overview.md +++ b/docs/kusion/1-what-is-kusion/1-overview.md @@ -10,7 +10,7 @@ Welcome to Kusion! This introduction section covers what Kusion is, the Kusion w ## What is Kusion? -Kusion is an intent-driven [Platform Orchestrator](https://internaldeveloperplatform.org/platform-orchestrators/), which sits at the core of an [Internal Developer Platform (IDP)](https://internaldeveloperplatform.org/what-is-an-internal-developer-platform/). With Kusion you can enable app-centric development, your developers only need to write a single application specification - [AppConfiguration](https://www.kusionstack.io/docs/concepts/app-configuration). [AppConfiguration](https://www.kusionstack.io/docs/concepts/app-configuration) defines the workload and all resource dependencies without needing to supply environment-specific values, Kusion ensures it provides everything needed for the application to run. +Kusion is an intent-driven [Platform Orchestrator](https://internaldeveloperplatform.org/platform-orchestrators/), which sits at the core of an [Internal Developer Platform (IDP)](https://internaldeveloperplatform.org/what-is-an-internal-developer-platform/). With Kusion you can enable app-centric development and your developers will only need to write a single application specification - [AppConfiguration](https://www.kusionstack.io/docs/concepts/app-configuration). [AppConfiguration](https://www.kusionstack.io/docs/concepts/app-configuration) defines the workload and all resource dependencies without needing to supply environment-specific values. Kusion ensures it provides everything needed for the application to run. Kusion helps app developers who are responsible for creating applications and the platform engineers responsible for maintaining the infrastructure the applications run on. These roles may overlap or align differently in your organization, but Kusion is intended to ease the workload for any practitioner responsible for either set of tasks. @@ -23,7 +23,7 @@ As a Platform Orchestrator, Kusion enables you to address challenges often assoc There are two key workflows for Kusion: -1. **Day 0 - Set up the modules and workspaces:** Platform engineers create shared modules for deploying applications and their underlying infrastructure, and workspace definitions for target landing zone. These standardized, shared modules codify the requirements from stakeholders across the organization including security, compliance, and finance. +1. **Day 0 - Set up the modules and workspaces:** Platform engineers create shared modules for deploying applications, the underlying infrastructure, and workspace definitions for target landing zones. These standardized, shared modules codify the requirements from stakeholders across the organization including security, compliance, and finance. Kusion modules abstract the complexity of underlying infrastructure tooling, enabling app developers to deploy their applications using a self-service model. @@ -32,7 +32,7 @@ There are two key workflows for Kusion: ![workflow](https://raw.githubusercontent.com/KusionStack/kusion/main/docs/platform_workflow.jpg) -2. **Day 1 - Set up the application:** Application developers leverage the workspaces and modules created by the platform engineers to deploy applications and their supporting infrastructure. The platform team maintains the workspaces and modules, which allows application developers to focus on building applications using a repeatable process on standardized infrastructure. +2. **Day 1 - Set up the application:** The platform team creates and maintains the workspaces and modules, which allows application developers to focus on building applications using repeatable processes on standardized infrastructure. Application developers leverage the workspaces and modules created by the platform engineers to deploy applications and the infrastructure to support the applications.
@@ -43,20 +43,20 @@ There are two key workflows for Kusion: * **Platform as Code** - Specify desired application intent through declarative configuration code, drive continuous deployment with any CI/CD systems or GitOps to match that intent. No ad-hoc scripts, no hard maintain custom workflows, just declarative configuration code. + Specify desired application intent through declarative configuration code, drive continuous deployment with any CI/CD or GitOps systems to match desired intent. No ad-hoc scripts, no hard-coded custom workflows, just declarative configuration code. * **Dynamic Configuration Management** - Enable platform teams to set baseline-templates, control how and where to deploy application workloads and provision accessory resources. While still enabling application developers freedom via workload-centric specification and deployment. + Enable platform teams to create baseline-templates, controlling how and where to deploy application workloads and provision accessory resources, while still enabling application developers freedom via workload-centric specification and deployment. * **Security & Compliance Built In** - Enforce security and infrastructure best practices with out-of-box [base models](https://github.com/KusionStack/catalog), create security and compliance guardrails for any Kusion deploy with third-party Policy as Code tools. All accessory resource secrets are automatically injected into Workloads. + Enforce security and infrastructure best practices with out-of-the-box [base models](https://github.com/KusionStack/catalog). Create security and compliance guardrails for any Kusion deployment with third-party Policy as Code tools. All accessory resource secrets are automatically injected into Workloads. * **Lightweight and Open Model Ecosystem** - Pure client-side solution ensures good portability and the rich APIs make it easier to integrate and automate. Large growing model ecosystem covers all stages in application lifecycle, with extensive connections to various infrastructure capabilities. + A pure client-side solution ensures good portability and the rich APIs make it easier to integrate and automate. A large growing model ecosystem covers all stages in the application lifecycle, with extensive connections to various infrastructure capabilities. :::tip -**Kusion is an early project.** The end goal of Kusion is to boost [Internal Developer Platform](https://internaldeveloperplatform.org/) revolution, and we are iterating on Kusion quickly to strive towards this goal. For any help or feedback, please contact us in [Slack](https://github.com/KusionStack/community/discussions/categories/meeting) or [issues](https://github.com/KusionStack/kusion/issues). +**Kusion is an early project.** The end goal of Kusion is to boost [Internal Developer Platform](https://internaldeveloperplatform.org/) revolution, and we are iterating on Kusion quickly to strive towards this goal. For help or feedback, please contact us in [Slack](https://github.com/KusionStack/community/discussions/categories/meeting) or [issues](https://github.com/KusionStack/kusion/issues).