Azure AI-102 AI Engineer Study Guide: Moving to MKDocs and GitHub Pages
- Andrew Kelleher
- Oct 9
- 2 min read
📢 TLDR: the AI-102 AI Engineer certification study guide is published on GitHub here
Moving to MKDocs+Material+GitHub Pages for Study Guides
Over the years, I’ve created study guides for Microsoft Azure certifications using one of two typical approaches:
Both approaches worked reasonably well for smaller sets of content, but they start to fall short as the amount of information grows.
Why the Blog Format Didn’t Work
Blog posts are great for storytelling and sharing updates, but they don’t scale well when you’re trying to build something structured and reference-heavy.
A single long post becomes hard to navigate, difficult to update, and almost impossible for others to contribute to meaningfully.
Even with tables of contents and headings, it never quite felt like the right tool for the job.
Notion Was Good… Until It Wasn’t
I’m a big fan of Notion. It’s clean, flexible, and brilliant for personal note-taking. For previous study guides, I experimented with publishing Notion pages as study guides. However, it’s not ideal for something I want to be community-led and frequently updated.
Exam topics change regularly, and while Notion does allow external editing, managing access and contributions can be a bit of a hassle. It adds unnecessary friction to what should be an open and simple process.
Moving to MKDocs + Material
For this study guide, I’ve taken a different approach. I’ve built the guide using MKDocs Material and published it via GitHub Pages. This brings several benefits:
🧭 Better structure and navigation – ideal for large amounts of content
🛠️ Easy to update – push a commit to GitHub, and the site updates automatically (Okay, I still need to create the GitHub Action for this!)
🌍 Open for contributions – anyone can fork, suggest changes, or open issues
✨ Clean presentation – without needing to maintain a complex CMS
I believe this setup aligns perfectly with the concept of a living study guide that can evolve as exam objectives change.
Check Out the AI-102 Study Guide
You can view the complete AZ-102 Study Guide here:
👉 AI-102 AI Engineer Study Guide published via GitHub Pages
👉 GitHub repository for the study guide
If you spot any errors or want to suggest additions, contributions are very welcome.
Finally, if you're currently studying for the AI-102 exam, good luck!
