The source for Azion's developer documentation.
Built with Astro and MDX, in English and Portuguese.
| If you want to | Go to |
|---|---|
| Read the documentation | azion.com/en/documentation |
| Report an error, request a page, or ask a question | Issue forms |
| Make a change | CONTRIBUTING.md |
| Understand the rules | GOVERNANCE.md |
| Find out who reviews what | CODEOWNERS |
| Get help with an Azion product | Azion Support |
Published content lives in src/content/docs/, split into en and pt-br. Pages are .mdx, so a page can pull in front-end components instead of being limited to prose. The site covers product reference, API reference, guides, use cases, and code samples.
English is the source of truth. Portuguese mirrors it, and divergence is tracked in an i18n issue rather than left silent.
We treat these pages as an API. People read them, but so do agents and crawlers through llms.txt, context7, and MCP. That makes frontmatter schema, heading structure, and working links contract requirements rather than style preferences.
You need Node 20.13.1 or newer and pnpm.
git clone https://github.com/aziontech/docs.git
cd docs
nvm use
pnpm install --frozen-lockfile
pnpm devBefore you open a pull request:
pnpm build:local # build + frontmatter validation
pnpm lint:slugcheck # permalink rulespnpm is the package manager of record. Do not commit npm or yarn lockfiles.
GOVERNANCE.md is the source of truth. If it contradicts any other document in this repository, including this one, it wins. The short version:
mainis the only long-lived branch. Work happens on short-lived branches that merge back within days.- Merges are squash only, so the pull request title becomes permanent commit history. Titles follow
type(scope): summaryand never carry ticket codes. - Technical content passes two gates. A subject matter expert confirms it is true, and a DevRel maintainer confirms it is well written and well placed.
- A permalink change without a redirect in the same pull request is a broken build.
- Expect a first response on any pull request within one business day.
CONTRIBUTING.md walks through all of it step by step. Contributions from outside Azion are welcome and get credited: fork the repository, branch, and open a pull request against main.
Everyone taking part here follows the Contributor Covenant Code of Conduct.
Released under the MIT License. Copyright (c) 2026 Azion Technologies.