+1 On Sep 11, 2013, at 10:42 AM, xavriley wrote:
> 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> 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> 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 > > 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 > > 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. > > 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 > 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 > 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. > 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 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. -- -- 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.
