Hello all,
I'm proposing that we migrate the website docs to AsciiDoc in order to set up multi-repo docs (i.e., collect docs from the cartridge repos and publish them all on the website). Markdown doesn't seem suited for this use case. For one thing, Markdown doesn't really support including an MD file within another MD. That's already a deal-breaker.
Migration should be easy because Jekyll has a plugin to support AsciiDoc and there are free tools to convert from Markdown syntax to AsciiDoc syntax.
Claude