clojure / clojure-site

clojure.org site
https://clojure.org
Eclipse Public License 1.0
249 stars 270 forks source link

Comparators guide #15

Closed puredanger closed 8 years ago

puredanger commented 8 years ago

Would be cool to see this guide by @jafingerhut turned into a guide: https://github.com/jafingerhut/thalia/blob/master/doc/other-topics/comparators.md

Note: this should only be done with Andy's ok! That's his copyright.

jafingerhut commented 8 years ago

Any Clojure contributor has my permission to use any or all of the material in my thalia Github repository and modify it as needed to create submissions for additions to this Github repository.

puredanger commented 8 years ago

Thanks Andy!

josedonizetti commented 8 years ago

Hey, I've forked the repo and will work on integrating this guide.

puredanger commented 8 years ago

Great! I expect the content to live at content/guides/comparators.adoc

puredanger commented 8 years ago

Added!

jafingerhut commented 8 years ago

@josedonizetti Thanks for the editing work on that article!

A couple of minor formatting issues remain that I noticed -- the list of items under DOs and DO NOTs all become one paragraph with the current markup.

Wherever <= occurs as a symbol in the article, for clojure.core/<=, it shows up as a special combined character rather than the two separate characters < followed by =, which would be clearer in its meaning.

One occurrence of "Firs" should be replaced with "First".

Sorry, I don't know what correct markup syntax is for these things.

josedonizetti commented 8 years ago

@jafingerhut Thanks. I'll look into those.

puredanger commented 8 years ago

I've got a bunch of formatting edits under way - I will take care of them.