AZ-400 Question 45
Select 2You maintain an Azure DevOps project that requires detailed documentation of your microservices architecture. Your team wants to create a wiki that is version-controlled in an existing Git repository and also wants to include process flow diagrams using Mermaid syntax. Which two actions must you take to meet these requirements?
- A
Add images of the process flow diagrams in PNG format to the repository and embed them in the wiki pages using Markdown image links.
- B
Publish your existing Git repository as a code wiki in Azure DevOps so that all markdown files, including diagram definitions, are version-controlled.
- C
Use fenced code blocks with 'mermaid' specified as the language in your markdown files to render the process flow diagrams automatically.
- D
Enable the built-in Mermaid extension under Project Settings > Wiki Extensions to activate diagram rendering.
Show answer and explanation
Correct answers: B, C
Explanation
To version-control your wiki content, you must publish a Git repository as a code wiki in Azure DevOps. Mermaid diagrams are rendered automatically when you include them in fenced code blocks labeled 'mermaid' in your Markdown content. This approach ensures you maintain a history of changes in your Git repo and benefit from generated process flow diagrams using native Markdown and Mermaid capabilities. For more details, see the Azure DevOps documentation on Markdown and Mermaid syntax (https://learn.microsoft.com/azure/devops/project/wiki/markdown-guidance).
- A. Incorrect.
Option 1 is incorrect. While embedding PNG images in Markdown is valid for static diagrams, it does not utilize Mermaid syntax. It also does not meet the requirement for automatically rendering process flow diagrams from text-based definitions.
- B. Correct.
Option 2 is correct. By publishing your Git repository as a code wiki, you ensure that every change to your wiki content is tracked in version control. This approach satisfies the requirement to keep the documentation in a Git repo.
- C. Correct.
Option 3 is correct. Mermaid diagrams are written as fenced code blocks labeled 'mermaid' in Markdown files. Azure DevOps Wiki will automatically render these diagrams when parsing your Markdown content.
- D. Incorrect.
Option 4 is incorrect. There is no separate Mermaid extension toggle under Project Settings in Azure DevOps. Mermaid diagram support is built into Azure DevOps Wikis and works by default when properly formatted in Markdown.