AZ-400 · Dokumentacja i współpraca
Project wiki a code wiki oraz diagramy Mermaid
Najważniejsze
- Project wiki powstaje razem z projektem i jest edytowane w interfejsie webowym.
- Code wiki publikuje Markdown z folderu gałęzi repozytorium Git, więc dokumentacja przechodzi zwykły przegląd pull requestów.
- Oba renderują Markdown i Mermaid: diagram zapisujesz tekstem (np. sequenceDiagram) w kontenerze ::: mermaid albo w bloku kodu oznaczonym mermaid, a wiki rysuje go jako obraz.
Źródło: https://learn.microsoft.com/en-us/azure/devops/project/wiki/markdown-guidance
Przykładowe pytania
Który rodzaj wiki w Azure DevOps publikuje pliki Markdown z folderu gałęzi repozytorium Git?
- Project wiki
- Code wiki
- Dashboard wiki
- Boards wiki
Pokaż odpowiedź
Odpowiedź: B. Code wiki
Code wiki jest mapowane na repozytorium, gałąź i folder. Project wiki powstaje z projektem i jest edytowane w interfejsie webowym.
Jakie typy diagramów możesz narysować za pomocą Mermaid w wiki Azure DevOps?
- Diagram sekwencji
- Diagram stanów
- Model procesu BPMN
- Osadzony rysunek Visio (.vsdx)
- Graf zasobów Terraform
Pokaż odpowiedź
Odpowiedź: A. Diagram sekwencji, B. Diagram stanów
Diagramy sekwencji i stanów należą do obsługiwanych typów Mermaid. BPMN, pliki Visio i grafy Terraform nie są typami diagramów Mermaid renderowanymi przez wiki.
Prawda czy fałsz: aby pokazać diagram Mermaid na stronie wiki Azure DevOps, trzeba go najpierw wyrenderować do PNG i wgrać obraz.
Pokaż odpowiedź
Odpowiedź: Fałsz
Fałsz. Diagram zapisujesz jako tekst, a wiki sama go renderuje, używając kontenera ::: mermaid lub bloku kodu oznaczonego mermaid.
Przećwicz 8 pytań z tego tematu w Bitzu
Krótkie lekcje, natychmiastowe wyjaśnienia i powtórki tego, w czym się mylisz. Za darmo na iOS i Androida.
