On Thursday, July 26, 2012 3:59:46 PM UTC-4, Aaron Lebo wrote:
>
> {snip}
The JVM really does have a wide swath of functionality already available.
> Some of the things that I ended up using were email libraries, date
> formatting libraries, and an rss feed generator. There never was a point
> where I felt like I was going to have to just roll things by hand. Most of
> the hard work has been done.
>
Curious: If you didn't find what you needed in Java's standard class
library, where else did you go looking for Java libraries?
> {snip} I found myself digging around in github repos to actual read code
> instead of documentation a lot more than I ever did with Python. Obviously
> these are just issues of time, and they'll improve.
One way that seems to me a good way to help projects get more docs is to
create a fork and add and/or improve existing docstrings.
Another way might be to fork, create a top-level doc dir, write and add a
.md file or two, and send a pull-request.
Another way might be to just add docs to the project's wiki, or write your
own docs (or even a blog post) and add a link to them from the project's
wiki.
Clojure docs and the cheatsheet help a lot, though.
>
Love these two resources. Note that there's some nice versions of the
cheatsheet with tooltips at http://jafingerhut.github.com/ .
> I guess if there is anything I'd love to see is some kind of style guide.
> {snip} There were lots of times I found myself wondering whether the
> "right" way was to indent the if form after the conditional or first
> argument, {snip} Does such a thing like PEP 8 exist for Clojure?
>
It seems to me that the 3 major style rules are:
1. line up args vertically,
2. use 2-space indents, and
3. let Emacs otherwise do indenting for you.
Minor note: that 3rd rule can be difficult to follow if, say, you're not
using Emacs. :)
> I'd love to see something which suggests how common tasks should be done,
I feel like it might help newbies like me feel more at ease.
This sounds like a job for a community-driven cookbook. There's a cookbook
at http://en.wikibooks.org/wiki/Clojure_Programming , but I'd always
figured that wikibooks was for "books", rather than for use as a general
wiki (please, correct me if I'm wrong here.). There also appears to be a
cookbook at http://www.gettingclojure.com/cookbook:clojure-cookbook .
It seems to me that a community-driven wiki would be a good place for a
cookbook (and other misc things) to live. (Personally, I like
[gitit](http://gitit.net/).
Well, those are some of my notes on using Clojure. I feel a little
> embarrassed writing this up because I feel like someone will pick it to
> death, {snip}
Great post. Thanks for writing this up!
---John
--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to [email protected]
Note that posts from new members are moderated - please be patient with your
first post.
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
