Skip to content

Getting started

Add or edit a page

  1. Add a Markdown file under docs/ (e.g. docs/runbooks/aks.md).
  2. Reference it in nav: in mkdocs.yml.
  3. Commit and push to main.
  4. CI (or az acr build) rebuilds the image; Argo CD redeploys automatically.

Preview locally

pip install mkdocs-material
mkdocs serve   # http://127.0.0.1:8000

Build the image manually (test path)

You need AcrPush on crneuronesitprdfrc01 (the NIT_EXPERTISE_AZURE_CONTRIBUTORS group already has it):

az acr build -r crneuronesitprdfrc01 -t mkdocs:0.1.0 .