On Jun 25, 12:14 am, Michael Klishin <michael.s.klis...@gmail.com>
wrote:
> John Gabriele:
>
> > Opinions? Concerns? Wild praise? Searing complaints? General disinterest?
>
> This is a great initiative but so far it seems to focus only on the API 
> reference part of documentation.

I'd think that autogenerated docstring docs would be api-focused. The
Alcove only has doc/*.md docs (plus examples) --- not necessarily API
docs at all.

> I personally think that documentation guides are just as important [1].

I agree. My thought is that authors would put their guides into doc/
*.md files.

---John

> For clojurewerkz.org projects, we put doc guides first:
>
> http://clojuremongodb.infohttp://clojureriak.infohttp://clojureneo4j.info

Certainly handsome docs. :)

---John

-- 
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

Reply via email to