| > can you include a glossary that connects all the marketing-slang to the common concepts that they represent? What you are calling "marketing slang" are actually "common concepts". The definition of common is highly context dependent. Here, the common concepts are what is known by a clojure programmer. > and a lot of it smells like a coffeehouse-MBA
>> The most exciting addition to the playground is the ability to use your own projects as the context for the Instarepl. You do this by using the lein-light leiningen plugin. Just run lein light from one of your projects and use the sidebar's connect verb to hook into it. What kind of MBAs you hang out with who know what is REPL, leiningen, plugin etc, and use it in the copy-writing? > A friendly (honestly!) tip about writing tutorials and helptext in general: the word "just" usually means it would be better to describe the actual steps to be taken. Think of it as a code-smell or a misplaced abstraction. So, every time he posts an update, he explains what is a REPL, leiningen, how to install leiningen, what is lein-light, how to install lein-light, what is clojure, how to install clojure? You just run lein light is perfectly reasonable. Had he gone into details about leiningen, that would have been fluff and totally unnecessary. LightTable is an IDE which right now is being developed for Clojure. If you don't know Clojure, you are't the target audience. I can assure you there isn't anything in the post which isn't obvious to a clojure programmer. |