Thanks for your comment. I've seen your code with categorization before. That's the same concept. The other one is used by quil author, but he uses two tags: category and subcategory and you can put your var into one category.

For examples, I understand that more sophisticated examples should be separated and embedded in separated documents, tutorials etc.

My goal was to enable something which can be called "unit examples". I need something which can illustrate one function at once to build reference like documentation.

like this page for example: https://processing.org/reference/quad_.html

Having such examples inline makes maintenance easier in my opinion.

Regarding your doctests - this is pretty cool concept.

interesting... it should be possible to use the machinery I built up in https://github.com/arrdem/stacks to execute an example again as a test. that's basically how the doctests system I prototyped out works, it just added some syntax sugar for writing assertions tersely.

I should have checked what was done in this area before 🙂 Great prototype.

However I prefer to utilize language itself instead of writing string parsers. But I think it's the matter of preference.

Nah! I think it’s great that people are kicking out prototypes in this area and thinking about it. Question is how to accumulate some efforts - see the good ’ol Lisp Curse.