Improving Examples and Documentation

[Vindaar]

I've mentioned the Clojure docs multiple times in the past myself (not sure if 
here in the forum, but for sure on matrix/discord). I fully agree that 
something along those lines would be exceptional to have. Those are not a 
_replacement_ for better normal docs, but an amazing addition that can have 
user guided information about the usage of code.