Bitzu

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

Single choice

Which Azure DevOps wiki type publishes Markdown files from a folder of a Git repository branch?

  1. Project wiki
  2. Code wiki
  3. Dashboard wiki
  4. 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.

Select all that apply

Which diagram types can you draw with Mermaid in an Azure DevOps wiki?

  1. Sequence diagram
  2. State diagram
  3. BPMN process model
  4. Embedded Visio (.vsdx) drawing
  5. 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

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.

Download on the App StoreGet it on Google Play

More AZ-400 topics in this module