Fork me on GitHub
#cljdoc
<
2018-11-03
>
martinklepsch14:11:48

I added two ADRs regarding examples... one documenting the decision to integrate examples and one with the decision to delay this further and focus on other stuff first: - https://github.com/cljdoc/cljdoc/blob/master/doc/adr/0014-add-support-for-examples.md - https://github.com/cljdoc/cljdoc/blob/master/doc/adr/0015-cancel-work-on-examples.md Let me know if my reasoning makes sense and if you have any thoughts on this in general.

❤️ 12
Jorin22:11:43

Really love the concept of working with ADRs! I also do support your decision 🙂 Feel like the value we see from the examples on http://clojuredocs.org for the stdlib might be misleading that this would work the same for other community packages. Authors should provide appropriate documentation, examples, tests, tutorials and all that stuff. For community packages we always have the choice to fork/contribute to a library or create our own solution if we have a simpler to understand idea or would like to provide some examples. We are less likely of doing that for clojure.core.