Joshua Bloch, http://www.scribd.com/doc/33655/How-to-Design-a-Good-API-and-Why-it-Matters http://www.scribd.com/doc/33655/How-to-Design-a-Good-API-and..., I bel

Joshua Bloch, http://www.scribd.com/doc/33655/How-to-Design-a-Good-API-and-Why-it-Matters http://www.scribd.com/doc/33655/How-to-Design-a-Good-API-and..., I believe had as one of his rules: "Example code should be Exemplary" (I don't see it in the slides, but it was in the video as I recall) Sample code lives forever; make sure you get it right! Of course, I didn't go to the primary sources for the article, so I could be completely wrong about the situation. edit: While I really like clojure, that isn't all its syntax, less macros. There's stuff like ` #() _ etc., although two out of three of those examples are shorthand for things you can do with the syntax he listed (quote and fn). I think you could easily fit it on a page, though.