# Concepts

> Key design decisions, personas, templating, and metadata reference for Capsule

> For the complete documentation index, see [llms.txt](https://deploy-preview-184--docs-projectcapsule.netlify.app/llms.txt).
> The HTML version of this page is at https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/.

Concept references explain reusable behavior shared across Capsule APIs:

- [Parameter Schemas and Dynamic Forms](./parameter-schema/): validate parameterized
  APIs with JSON Schema and Kubernetes CEL, and populate client forms from arbitrary
  Kubernetes resources.
- [Managed Resources and Server-Side Apply](./managed-resources/): understand field
  ownership, adoption, protection, cleanup policies, and processed-resource status.

## Pages in this section

- [Architecture](https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/architecture/index.md): Architecture references and considerations
- [Parameter Schemas and Dynamic Forms](https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/parameter-schema/index.md): Validate parameterized APIs with JSON Schema and Kubernetes CEL, and enrich clients with live Kubernetes resource selectors.
- [Managed Resources and Server-Side Apply](https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/managed-resources/index.md): Ownership, server-side apply, resource policies, and status for TenantResource and GlobalTenantResource replications.
- [Known Metadata](https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/known-metadata/index.md): Labels and Annotations in Capsule Items
- [Templating](https://deploy-preview-184--docs-projectcapsule.netlify.app/docs/operating/concepts/templating/index.md): Templating in Capsule Items

---

Last modified October 21, 2026: chore: merge release branch (#165) (69f84ec)