Why MKDocs Material

Markdown

• portable
• extendable

Features

• Search 🔎
• Google Analytics 👀
  • which pages have the most/least views?
• Diagrams
  • Mermaid.js Diagrams 🎨
  • We could import more libraries like Diagrams
• Icons

Git

• code review 👀
  • more people will know about docs
  • peer reviewed & higher quality docs
• every line has a "last updated date"
• GitHub actions (CI/CD)

Python

• inclusive: all devs and analytics at Forma use Python

Where to learn more about MKDocs

• mkdocs.org
• MKDocs Material Theme

---

Last update: 2023-04-24