cert-manager/website

The cert-manager website is a documentation and project information site built with Next.js and MDX.

The project solves the problem of maintaining comprehensive, versioned documentation for cert-manager across multiple release cycles. It uses a branching strategy where the master branch reflects the current stable version's documentation, while the release-next branch stages documentation for unreleased features. Documentation content is organized in the content directory with version-specific folders for released versions and a docs folder for current and unversioned content like contribution guides and release notes. All documentation is written in Markdown and compiled through Next.js.

The site is suitable for anyone contributing to cert-manager documentation or maintaining the project's public-facing information. Contributors should understand the branching model: changes to master appear on the live site shortly after merge and apply to released versions, while release-next changes appear on a preview deployment for upcoming features. Documentation changes typically belong in the content directory, with specific guidance on whether to update the current docs folder, version-specific folders, or both depending on whether the change applies to released versions, unreleased features, or unversioned content. The README emphasizes asking the maintainers via Slack if the correct location is unclear.

Development requires Node.js version 16 or higher, Golang version 1.17 or higher, cURL, and GNU coreutils. The project maintains separate documentation branches to handle the complexity of supporting multiple cert-manager versions simultaneously, with clear conventions for relative linking between documentation pages using markdown file references rather than full URLs.