> Rust uses "Code on Comments" and often not highlighted, linted, smart > autocompleted, etc as actual code. (Yes Ive used some Rust on modern IDE)
dunno, but vscode supports it generally ([https://code.visualstudio.com/docs/editor/intellisense#_customizing-intellisense)](https://code.visualstudio.com/docs/editor/intellisense#_customizing-intellisense\)), as does the fancy web page above that views the documentation - it's certainly not a technical impossibility - worth keeping in mind that documentation is written once, but read over and over again, thus it makes sense to optimize it for the viewer. > You can just write runnableExamples on a separate file and include it. How does this address the points above? It moves the examples further away from the code being documented, still leaves no control for the author to mix code and comment, and generally just feels.. complicated.
