Having clojuredocs updated would be a fantastic thing. As a website, it's really nicely done, and very usable. But, it will become increasingly irrelevant if it remains out of date.
Even better would be to have clojuredocs support additional libraries, perhaps with some selector so that the index doesn't show all of the functions all of the time. But 1.5 is most essential of all. Phil xavriley <i...@xavierriley.co.uk> writes: > I've just picked up on this thread but I've spent quite a bit of time > barking up this tree. > > There are three repos that power the old version of the site > > https://github.com/zk/clojuredocs - the Rails 2 frontend > https://github.com/zk/clojuredocs-analyzer - the clojure analyzer that > extracts data from Clojure Core and other projects > https://github.com/zk/cd-wsapi - the API that handles CLI integration > > I've got a pull request sitting there for the analyzer which makes it work > with Clojure 1.5.1 > > https://github.com/zk/clojuredocs-analyzer/pulls > > But I've not had any response from the maintainers yet. I've tried catching > them on IRC but I haven't heard anything since I submitted the PR. > > I could just host a fork of Clojuredocs myself with 1.5.1 but I think > that's the wrong way to do this. I have had some success in forking the > project for Overtone documentation and Core.logic docs which you can see > here: > > http://overtone-docs.herokuapp.com/ > http://corelogicdocs.herokuapp.com/ > > So it's entirely possible to work with what's there. I'll try getting in > touch with dakrone to see if we can make this update happen. > > > > On Wednesday, September 11, 2013 8:57:21 AM UTC+1, Colin Fleming wrote: >> >> Something that I've always wondered - why is ClojureDocs not updated? I've >> never tried to contribute to it - is it particularly difficult? Is it >> impossible for users to add support for new Clojure versions? If so, who >> runs it? Could it be turned over to the community? >> >> >> On 11 September 2013 17:55, Steven Degutis <sbde...@gmail.com<javascript:> >> > wrote: >> >>> All very good points. >>> >>> One of my assumptions was that people don't use wikis simply because >>> it's Yet Another Account to sign up for, so this being hosted on >>> github would be a much lower barrier-to-entry for contributing >>> examples. But I'm not sure that's a valid assumption for anyone >>> besides just me. >>> >>> And I wasn't suggesting that the structure be edited. I was imagining >>> an unwritten rule where only examples would be edited/added, and the >>> rest of the structure of each page remain the same. That would make >>> parsing the wiki partially manageable. But I'm not sure how realistic >>> that is in practice. >>> >>> Thanks for your feedback. >>> >>> -Steven >>> >>> On Wed, Sep 11, 2013 at 12:39 AM, John Gabriele >>> <jmg...@gmail.com<javascript:>> >>> wrote: >>> > On Sunday, September 8, 2013 4:07:33 AM UTC-4, Steven Degutis wrote: >>> >> >>> >> >>> >> https://github.com/sdegutis/clojuredocs/wiki >>> >> >>> >> {snip} >>> >> >>> >> Thoughts? >>> >> >>> > Hi Steven, >>> > >>> > This is a nice piece of work. Thank you. >>> > >>> > Some thoughts: >>> > >>> > * Wikis are difficult to keep nice. And, seemingly contradictory to >>> that, >>> > it's difficult to find contributors. >>> > >>> > * There is already a Clojure wiki, >>> > <http://en.wikibooks.org/wiki/Clojure_Programming>, but it does not >>> see many >>> > updates. >>> > >>> > * I really like clojuredocs.org's clean (and enforced) separation of >>> > examples, see-also, and comments. >>> > >>> > * Although github's wiki feature is handy, for a pure wiki there are >>> > better solutions, IMO (for example, my favorite is >>> > [gitit](http://www.gitit.net/)). >>> > >>> > * I think some of the work necessary to replace/rewrite >>> clojuredocs.org >>> > has already been done by dakrone. Dunno the status of it though. >>> > >>> > * I think it's worthwhile to pull docstrings directly from Clojure >>> itself. >>> > Fixing docstring typos in a wiki is nice, but I'd rather see fixed the >>> > actual source docstrings themselves... >>> > >>> > -- John >>> > >>> > -- >>> > -- >>> > You received this message because you are subscribed to the Google >>> > Groups "Clojure" group. >>> > To post to this group, send email to clo...@googlegroups.com<javascript:> >>> > Note that posts from new members are moderated - please be patient with >>> your >>> > first post. >>> > To unsubscribe from this group, send email to >>> > clojure+u...@googlegroups.com <javascript:> >>> > 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+u...@googlegroups.com <javascript:>. >>> > For more options, visit https://groups.google.com/groups/opt_out. >>> >>> -- >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To post to this group, send email to clo...@googlegroups.com<javascript:> >>> Note that posts from new members are moderated - please be patient with >>> your first post. >>> To unsubscribe from this group, send email to >>> clojure+u...@googlegroups.com <javascript:> >>> 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+u...@googlegroups.com <javascript:>. >>> For more options, visit https://groups.google.com/groups/opt_out. >>> >> >> > > -- -- Phillip Lord, Phone: +44 (0) 191 222 7827 Lecturer in Bioinformatics, Email: phillip.l...@newcastle.ac.uk School of Computing Science, http://homepages.cs.ncl.ac.uk/phillip.lord Room 914 Claremont Tower, skype: russet_apples Newcastle University, twitter: phillord NE1 7RU -- -- 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/groups/opt_out.
