Hi, I apologise if this is not the appropriate forum, but please bear with me.
Having watched Bozhidars Clojutre presentation, https://www.youtube.com/watch?v=nrpsMB2gYI0&index=2&list=PLetHPRQvX4a9iZk-buMQfdxZm72UnP3C9 <https://www.youtube.com/watch?v=nrpsMB2gYI0&index=2&list=PLetHPRQvX4a9iZk-buMQfdxZm72UnP3C9>, I think he brings up some valid points. To me, the most interesting point is the formatting of the doc-strings in Clojure core. If you compare them (as Bozhidar does) with the doc-strings in Emacs, you’ll see that Clojure’s variant lacks quite a bit of formatting/conventions which make it hard for tooling to help the user with great documentation. In fact, Emacs has its own package which can be used to check that the documentation follows certain rules, http://cedet.sourceforge.net/checkdoc.shtml <http://cedet.sourceforge.net/checkdoc.shtml> I guess what I’d be interested in discussing would be how to move forward on this. I think one viable way would be for the maintainers of the two major IDE’ (Cider and Cursive) to sit down over a couple of (virtual) ciders and come up with a format, and start implementing this, see if it gains traction in the community released software, and then at last see if the format could be incorporated into Clojure core. Anyone? Erik. -- 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.
