On Thu, 16 Dec 2010 10:18:47 -0700 Terrance Davis <terrance.da...@gmail.com> wrote:
> *begin rant* > > I have yet to see anyone who posts the classic "rtfm" (even politely) > response search previous posts and realize that "rtfm" responses have > already been sent and refrain from sending the same explanation of how > to use a mailing list over and over and over. Simple customer service > experience teaches that if customers are asking the same questions > multiple times, then the documentation is either, hard to find, > incomplete, or not clear enough. Improving the docs is a healthier and > more productive use of time than starting yet another thread on how to > use a mailing list. > > *end rant* > > Sorry. Couldn't contain myself ;-) No need to be sorry - it's a very good point. In the past, I've contributed to open source projects by watching for the same question to be raised multiple times, combining the data in the best answers into one "best of breed", and submitting it as a patch for the project handbook. The clojure community doesn't have anything as spiffy as the FreeBSD handbook - instead we have a wiki FAQ page (from clojure.org, click "wiki" then "2 FAQ" to get to http://en.wikibooks.org/wiki/Clojure_Programming). While much more painful than editing docbook, it's a good place to post things. Unfortunately, we can't post excerpts from clojure source there because the wiki license is incompatible with the source license - or anything else using that same license. In particular, not being able to use doc strings, etc. Given that the FAQ itself suggests that such be posted to the clojure group, this makes doing what I did rather problematical. Minimally, I need to figure out whether or not a post contains such an excerpt in order to be able to use it. Worst case, the license for content posted to the group is *also* incompatible with the source license, so you can't legally add any Frequent Answers from there to the FAQ. Ok, I found a problem. Anyone got solutions? <mike PS: behavior-modification posts (i.e. - the "rtfm" posts) needs to be done repeatedly because (we hope) the group keeps growing. If everyone simply ignores improper behavior, the newcomers will assume it's proper behavior (even if there's a covenant for the group saying otherwise). Hence periodic reminders are called for. -- Mike Meyer <m...@mired.org> http://www.mired.org/consulting.html Independent Network/Unix/Perforce consultant, email for more information. O< ascii ribbon campaign - stop html mail - www.asciiribbon.org -- 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
