docs: How to handle code snippets?

[afontcu]

Almost every page on docs have some code snippets. The question is:

How can we make sure that these examples are working as expected? How can we make sure that these examples will continue to work as expected? It would be really bad to provide broken, outdated samples.

For now, I've been writing samples in VTU-next repo, running them along the tests. However, this scales poorly, and there's no way we can ask contributors to do so (and, even then, make sure they did).

Is there a way to import code snippets from somewhere else, where they can be run and tested?

Are there other alternatives?

[leopiccionia]

May the Import Code Snippets be the feature you want? It even allows importing code regions, what's pretty neat -- no need for hardcoding line numbers in Markdown.

[afontcu]

Oh, looks promising 🤔 gonna take a look! Thanks :)