$ show cdk8s-team/cdk8s
The cdk8s repository is an umbrella project that coordinates the CDK8s framework for generating Kubernetes manifests from code in multiple programming languages. It manages the project's website, documentation, and tooling, including automation for importing Kubernetes API schemas, generating documentation, and maintaining dependencies. The core framework logic resides in separate repositories (cdk8s, cdk8s-cli, cdk8s-plus), while this repo focuses on ecosystem support, version tracking, and community engagement through documentation, RFCs, and research into high-level abstractions. Key operational components include a Hugo-based website with Webflow-generated assets, MkDocs-driven documentation that auto-extracts API references from published packages, and Projen-managed project configuration. The repository features automated workflows for dependency upgrades, Kubernetes schema imports, and issue triage, demonstrating a commitment to maintenance and ecosystem compatibility. While containing a research directory for exploring L2 constructs, this activity is strictly in service of framework improvement rather than independent data research. The project exhibits strong engineering practices through its automation pipelines, dependency pinning, and versioned documentation strategy. Technical drift is low due to proactive updates via scheduled workflows and careful management of Kubernetes version alignment. The architecture emphasizes separation of concerns, with clear boundaries between website, documentation, tooling, and external framework packages.
The LLM identified 2 files worth highlighting for reuse:
Automates extraction of API references from installed cdk8s and cdk8s-plus npm packages into the documentation directory, then builds the MkDocs site. This self-contained script demonstrates reusable documentation automation by decoupling API reference extraction from static content, allowing easy adaptation for other projects needing versioned API docs from dependencies.
Downloads and processes Kubernetes OpenAPI specs for a given version, converting them to JSON schema via openapi2jsonschema with specific filtering to remove unsupported definitions. This script provides a reusable pattern for OpenAPI-to-JSON schema conversion, encapsulating dependency handling and post-processing logic in a portable, parameterized shell script.