The Chainguard Academy repository serves as the documentation and tutorial hub for Chainguard's developer-focused security and software supply chain solutions. Hosted at edu.chainguard.dev, the repository contains educational resources designed to help developers build software efficiently and securely using Chainguard's tools and practices. The primary codebase is written in SCSS and is built on the Doks Hugo theme, enabling the team to maintain a static site that delivers educational content about containerization, DevSecOps, cloud-native security, and secure development practices.
The repository's content is organized primarily in Markdown files within a content directory, covering topics spanning software supply chain security, CI/CD pipelines, infrastructure as code, vulnerability management, and container education.
Development and contribution processes are structured around quality assurance and accuracy verification. The README emphasizes that all documentation published to Chainguard Academy undergoes careful review, with GUI procedures, API commands, and CLI code snippets tested thoroughly by both authors and reviewers to ensure readers can follow along and achieve the same results. The testing pipeline includes local preview capabilities through npm-based development, pre-commit hooks that manage dates and validate tags, and Netlify deploy previews for every pull request that allow reviewers to examine rendered content before publication.
The repository maintains automated quality controls through pre-commit hooks that handle date management, tag validation, and spell-checking. Contributors are expected to follow specific formatting conventions, including YYYY-MM-DD date formats in post headers and a standardized tag taxonomy that distinguishes between content topics and content types. Image contributions require file size optimization using tools like TinyPNG, and images should be bundled with their corresponding Markdown files in organized directory structures. Video embedding is supported through liquid tags for YouTube content.
