AZ-400 ยท Documentation and collaboration
Project wiki vs code wiki, and Mermaid diagrams
Azure DevOps project and code wikis, GitHub wiki and README docs, Markdown features, Mermaid syntax for flowcharts and sequence diagrams.
Key points
- A project wiki is provisioned with the project and edited in the web UI.
- A code wiki publishes Markdown from a folder of a Git repository branch, so docs follow normal pull request review.
- Both render Markdown and Mermaid: write the diagram as text (for example a sequenceDiagram) inside a ::: mermaid container or a fenced block tagged mermaid, and it is drawn as a picture.
Source: https://learn.microsoft.com/en-us/azure/devops/project/wiki/markdown-guidance
Practice questions
Which Azure DevOps wiki type publishes Markdown files from a folder of a Git repository branch?
- Project wiki
- Code wiki
- Dashboard wiki
- Boards wiki
Show answer
Answer: B. Code wiki
A code wiki is mapped to a repo, branch and folder. A project wiki is the one created with the project and edited in the web UI.
Which diagram types can you draw with Mermaid in an Azure DevOps wiki?
- Sequence diagram
- State diagram
- BPMN process model
- Embedded Visio (.vsdx) drawing
- Terraform resource graph
Show answer
Answer: A. Sequence diagram, B. State diagram
Sequence and state diagrams are among the supported Mermaid types. BPMN, Visio files and Terraform graphs are not Mermaid diagram types the wiki renders.
True or false: to show a Mermaid diagram in an Azure DevOps wiki page you must first render it to a PNG and upload the image.
Show answer
Answer: False
False. You write the diagram as text and the wiki renders it, using a ::: mermaid container or a fenced code block tagged mermaid.
Practice 8 questions on this topic in Bitzu
Short lessons, instant explanations and spaced review of what you get wrong. Free on iOS and Android.
