Building a web catalogue for private Bicep registries
Documentation: Often the least favorite aspect of coding, especially for those of us working with Bicep in cloud engineering. Yet, what if there were ways to not just simplify, but actually enjoy the process of creating documentation for your Bicep code? Join us as we delve into the journey of building a web catalog for your private Bicep registry. We will begin with an introduction to the public registry for Bicep modules and then look at why you would still consider a private registry. From there, we dive into the advanced techniques of leveraging PSDocs for generating in-depth documentation for your Bicep modules. We will then demonstrate how to consolidate these markdown files into a cohesive catalog using MKDocs, incorporating Material design for an enhanced visual appeal. Our focus will be on hands-on demonstration, enabling you to directly apply these insights and techniques to your projects and workflows. This practical approach will cover a range of tools, including Azure, Bicep, PowerShell, GitHub Actions, PSDocs, and MKDocs, but the knowlegde can be used with a different stack as well. Target audience: IT Engineers, DevOps Engineers
