Clojure has great data, and great metadata. Documentation strings are *not* great data, they are strings.
If you want to provide more structured support than docstrings to help someone use Clojure, look at specs for inspiration. They are made of data, and they live in a registry separate from Clojure's var system. This kind of decoupling supports composition and tooling without requiring any addition or change to Clojure. I would also echo Matching Socks: Having more and better guides at clojure.org would be great. The contribution process is described at https://github.com/clojure/clojure-site/blob/master/content/community/contributing_site.adoc . Regards, Stu On Mon, Sep 11, 2017 at 5:23 AM, Matching Socks <phill.w...@gmail.com> wrote: > I am not convinced I would have found the API docs on reducers or zippers > more informative if all references had been tidily markdown'ed. > > The new clojure.org welcomes contributions of topical overviews. That's > helpful. > > But, to interpret docstrings, nothing helps like perspective. The thing > about perspective is that there could be so many. I like "Clojure > Programming" by Emerick, Carper & Grand. > > -- > You received this message because you are subscribed to the Google > Groups "Clojure" group. > To post to this group, send email to clojure@googlegroups.com > Note that posts from new members are moderated - please be patient with > your first post. > To unsubscribe from this group, send email to > clojure+unsubscr...@googlegroups.com > For more options, visit this group at > http://groups.google.com/group/clojure?hl=en > --- > You received this message because you are subscribed to the Google Groups > "Clojure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to clojure+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
