dapr/docs

Dapr docs is a documentation repository that builds the user-facing documentation website for Dapr, a cloud-native microservices runtime.

This repository contains the markdown source files that generate the Dapr documentation website. The docs are built using Hugo with the Docsy theme and hosted on Azure Static Web Apps. The repository uses a version-based branching strategy where each branch corresponds to a major and minor version of a Dapr runtime release, allowing documentation to track multiple active versions simultaneously. Contributors can run the documentation locally using either a devcontainer with VSCode or GitHub Codespaces, or by manually installing Hugo extended version and Node.js.

Anyone contributing to Dapr's documentation should use this repository. It suits teams maintaining documentation for versioned software releases, particularly those already using Hugo and wanting a structured approach to managing docs across multiple runtime versions. The devcontainer setup removes friction for contributors by pre-installing all dependencies and VSCode extensions, making it accessible to those unfamiliar with Hugo or the project's tooling.

The project maintains multiple active documentation branches aligned with Dapr runtime versions, with the primary branch receiving typo fixes and clarifications while pre-release branches handle version-specific documentation updates. Contribution guidelines are documented within the docs themselves, and the repository provides clear setup paths for both containerized and manual local development environments.