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 <sbdegu...@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 <jmg3...@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 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. > -- -- 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.
