On Wednesday, May 6, 2015 at 9:15:53 PM UTC+2, Andy Fingerhut wrote:
>
> I am not 'in the know' on decisions regarding clojure.org.
>
> [...]
>
What I find more interesting than the portion of Sean Corfield's post that 
> you chose to quote, was this one (emphasis added by me):
>

  

To clarify, because I detect an implication in your words: I never said the 
part I “*chose to quote*” was the most “*interesting*”. It was merely the 
one which I wished clarification on. (The answer affects a planned action 
of mine.) 

Good to hear Alex Miller spends much time on documentation. Others, like 
Kathy Sierra, not only do so, but under infinitely worse conditions. I 
respect them all. 

Personally, I allocate much time on technical docs too. I’m participating 
in Clojurebridge soon, not to mention the private mentoring where I write 
“class notes” most days a week. I’m behind on them; here’s my backlog of 
classes to illustrate: 

   - suddenly jumped from machine language <http://www.catonmat.net/c/76625> 
   to get high-level perspective: 
      - class where I explained data (used Clojure datastructures, as it’s 
      the clearest) 
      - class where I explained code (used a simple lisp, and basically 
      explained an evaluator) 
   - class on I/O: polling vs. interrupts vs. hybrid; memory mapped vs. 
   port mapped 
   - class introducing C: lldb, offered choice of texts 
   - class explaining “what’s a sourcecode file”: inodes 

(And the task requires skills like a certain kind of brevity; reaching down 
into underlying concepts; visual details like non-intimidating typefaces, 
etc.)

Admittedly, for the Clojure community, I only contributed this doc: 
http://clojure-doc.org/articles/cookbooks/strings.html … after which I 
decided to allocate my time to efforts which (hopefully) help people more 
than liberating programmers from technological drudgery. 

Anyway, I retract my tiny question; I’ll just privately ask people I know.

-- 
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.

Reply via email to