News for hackers. Stuff that matters.
Re:Results of the 2012 State of Clojure survey by technomancy on Monday August 06, 2012 @05:36PM (#4347409)
> having on-demand online docs for any clojar or github repository would go a long way.

How so? Isn't GitHub already its own on-demand online docs service?

https://github.com/technomancy/leiningen/tree/master/doc

https://github.com/technomancy/clojure-mode/blob/master/doc/...

Re:Results of the 2012 State of Clojure survey by cldwalker on Monday August 06, 2012 @08:31PM (#4348034)
By linking to rubydoc.info, I was referring to online docs that index functions/namespaces/classes/files and make them searchable which is different than reading formatted markdown.

On second thought, I'm not sure if any of this would go a long way as I don't know clojure's culture too well yet. I just know I've found indexed docs to be valuable in ruby when linking to and discussing a library's API.

Re:Results of the 2012 State of Clojure survey by technomancy on Monday August 06, 2012 @10:01PM (#4348298)
Yeah, the main difference is that Clojure docstrings are available at runtime, so it's easiest just to query a running instance; you don't need to switch to a browser to do that kind of thing.

There's a place for API reference pages, but considering that most tools to generate it require evaling the code in question, a third-party hosting service would have to implement some fancy sandboxing and wouldn't really offer much over GitHub Pages since it's just static HTML.

But I don't think when people complain about documentation that they're complaining about API reference. I suspect people want accessible tutorial-style prose and introductions. But maybe next year's survey could distinguish between the two.