Discuss link https://discuss.ocaml.org/t/2025-documentation-best-practices/17008/35
Reflecting on that discussion, I wondered whether it would be technically possible to use a tool like md2mld and manage to have a compilation mode for the doc where the Markdown contents of the docs/ is injected into the odoc site under construction, respecting the diataxis structure.
I need to do some [o]?digging around, maybe this doesn't make sense, I haven't thought about this carefully this is just a thought.
Discuss link https://discuss.ocaml.org/t/2025-documentation-best-practices/17008/35
Reflecting on that discussion, I wondered whether it would be technically possible to use a tool like
md2mldand manage to have a compilation mode for the doc where the Markdown contents of the docs/ is injected into the odoc site under construction, respecting the diataxis structure.I need to do some
[o]?diggingaround, maybe this doesn't make sense, I haven't thought about this carefully this is just a thought.