Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

added README w/ contribution instructions

  • Loading branch information...
commit 25f66959f2115aa28d6e4fd68bbb057edf14f717 1 parent d6056f7
@cemerick authored
Showing with 28 additions and 0 deletions.
  1. +28 −0 README.asciidoc
28 README.asciidoc
@@ -0,0 +1,28 @@
+I designed the[original] _Clojure type selection_ flowchart earlier in 2011:
+Since then, it has been translated to[Japanese],[Dutch], and[Portugese].
+I wanted to make it easier for others to produce translations of the flowchart, since it seems to be very helpful to people, especially as they are learning Clojure. Thus, I created this repo and added the original[OmniGraffle] file. I hope that, _if you know a language well_ that does not yet have a translation of the flowchart, you'll take a few minutes to produce one.
+Editing the OmniGraffle file is a piece of cake, and[Omni Group] offers 14-day trials of the software that you can use to make the necessary changes.
+(The `.graffle` file is actually just XML, so it's plausible that you'd be able to perform the translation without using OmniGraffle. I'll happily perform the export to `.png` in this case.)
+=== Providing a translation
+1. Clone this repo.
+2. Copy `choosingtypeforms.graffle` to `translations/<YOUR LANGUAGE>.graffle
+3. Make the necessary changes, adding an translator attribution to the lower-right of the page and a URL for yourself if you like.
+4. Export the result as PNG to `translations/<YOUR LANGUAGE>.png`
+5. Send me a pull request.
+=== Publication
+This flowchart will be featured in an appendix in the forthcoming[_Clojure Programming_] from O'Reilly, by myself, Christophe Grand, and Brian Carper.
+[Original Clojure type selection flowchart] © 2011 Chas Emerick <[]>

0 comments on commit 25f6695

Please sign in to comment.
Something went wrong with that request. Please try again.