docs

About docs of Clojure & libs
genmeblog 2018-02-16T08:59:56.000408Z

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.

genmeblog 2018-02-16T09:04:20.000314Z

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

genmeblog 2018-02-16T09:07:37.000359Z

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.

genmeblog 2018-02-16T09:07:44.000211Z

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

genmeblog 2018-02-16T09:08:19.000122Z

Having such examples inline makes maintenance easier in my opinion.

genmeblog 2018-02-16T09:16:26.000132Z

Regarding your doctests - this is pretty cool concept.

arrdem 2018-02-16T17:22:00.000100Z

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.

genmeblog 2018-02-16T22:31:00.000050Z

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

genmeblog 2018-02-16T22:31:40.000291Z

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

arrdem 2018-02-16T23:29:40.000245Z

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.