Author Posts

August 11, 2018 at 3:17 pm

Comment-based help has long been considered a best practice. However, it doesn't natively support localization or online help updates. Markdown has emerged as a better source in some ways. Using PlatyPS, it can be turned into "real" MAML-based help, which supports localization and online updates, and obviously offers an easy transition to online web-based help, too.

I recently saw a Twitter conversation, however, about using comment-based help in order to keep the docs "attached" to their code. Then, in a CI pipeline, comment-based help is extracted, turned into Markdown, and then published to the web or to MAML files.