The Demo sandbox is completely unusable :(

Helpful

The link is broken... anyone got a cached version or something?

2 different things https://swimm.io/blog/code-comments-vs-documentation/

That does not solve describing flows or patterns in the code

This is why projects with micro service architecture are best saved in a mono repo

I think the monorepo question is complicated, but this is generally a strong element in the pros column. One exception to that is when you want decoupling for other reasons, the pressures of multiple repos can help motivate it in the day-to-day.

You can use the CI to publish you md files with tools like https://docusaurus.io/

Well... posting it here will only increase the number of requests and will make the investigation harder

You can also puppetize the links like this: https://puppetizer.web.app/microsoft/vscode/issues/19

Puppetize code is available here: https://github.com/navotgil/puppetizer

Thanks, very interesting