That's cool that you've found a way to test the code that's embedded in your docs. Google has infrastructure for inserting code from a GitHub repo into docs [1]

That's cool that you've found a way to test the code that's embedded in your docs. Google has infrastructure for inserting code from a GitHub repo into docs [1] but I haven't heard of anyone extracting the code from the docs and testing it. One thing that you might want to look into is conditionally displaying parts of the code. For example, suppose that for a given doc, you only need to display one line of code. But to get the code runnable, you need to put in some boilerplate. There should be a way to only display the one line of relevant code. // START_EMBED fetch("example.com"); // END_EMBED // Boilerplate infrastructure that the user doesn't need to see. new Test().run(); One advantage of the Google approach is that you write the code once, but can insert code one line at a time into the doc. For example, suppose you start off with the full code sample. const service = new Service(); service.init(); service.doStuff(); service.terminate(); But then you want to discuss the first line: const service = new Service(); Then the second, and so on. The Google markup looks something like this: // START_FULL // START_CONSTRUCTOR const service = new Service(); // END_CONSTRUCTOR // START_INIT service.init(); // END_INIT service.doStuff(); service.terminate(); // END_FULL And then to embed a certain snippet into each doc you just do something like this: {% includecode "https://github.com/.../code.js" snippet="FULL" %} [1] https://news.ycombinator.com/item?id=17835045 https://news.ycombinator.com/item?id=17835045