On Tuesday, April 29, 2014 8:47:58 PM UTC-7, da...@axiom-developer.org wrote: > Can I ask, quite seriously and not intending any sarcasm, what you mean > by "detracts from what's important"?
What's important is writing clear explanatory prose. This is really hard to do for a lot of reasons, but none of them are technical. Organizing your thoughts is hard. Thinking like a newcomer is very hard. Achieving clarity on any subject matter is hard. Knowing when to update is hard. Editing is hard. (And you can't effectively act as your own editor.) Putting words into a file on disk is easy, and rendering those words in a way that is convenient for others to read is very easy. -Phil ps. I hope that anyone who's interested in improving the documentation situation will look to Jacob Kaplan-Moss's articles on the topic, which do a better job of laying out the problem than I could do: http://jacobian.org/writing/what-to-write/ -- 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/d/optout.
