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.
