https://github.com/cemerick/clojure-type-selection-flowchart
Flowchart for choosing the right Clojure type definition form
https://github.com/cemerick/clojure-type-selection-flowchart
Last synced: 6 months ago
JSON representation
Flowchart for choosing the right Clojure type definition form
- Host: GitHub
- URL: https://github.com/cemerick/clojure-type-selection-flowchart
- Owner: cemerick
- Created: 2011-11-17T14:26:31.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2018-02-01T05:06:35.000Z (about 8 years ago)
- Last Synced: 2025-10-06T03:36:06.379Z (6 months ago)
- Homepage: http://cemerick.com/2011/07/05/flowchart-for-choosing-the-right-clojure-type-definition-form/
- Size: 1.54 MB
- Stars: 252
- Watchers: 10
- Forks: 15
- Open Issues: 3
-
Metadata Files:
- Readme: README.asciidoc
Awesome Lists containing this project
- awesome - cemerick/clojure-type-selection-flowchart - Flowchart for choosing the right Clojure type definition form (<a name="Not%20Set"></a>Not Set)
README
I designed the http://cemerick.com/2011/07/05/flowchart-for-choosing-the-right-clojure-type-definition-form/[original] _Clojure type selection_ flowchart earlier in 2011:
image::https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/choosingtypeforms.png[]
Since then, it has been translated to:
* https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/translations/dutch.png[Dutch] (https://github.com/Borkdude[Michiel Borkent])
* https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/translations/japanese.png[Japanese] (https://twitter.com/#!/omasanori[OGINO Masanori])
* https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/translations/portuguese.png[Portuguese] (http://codemountain.wordpress.com/2011/08/22/flowchart-de-apoio-a-escolha-tipos-em-clojure[Paulo Suzart])
* https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/translations/german.png[German] (http://blog.licenser.net[Heinz N. Gies])
* https://github.com/cemerick/clojure-type-selection-flowchart/raw/master/translations/spanish.png[Spanish] (http://www.andresvalenciano.com/[Andrés Valenciano])
* https://raw.github.com/cemerick/clojure-type-selection-flowchart/master/translations/chinese.png[Chinese] (http://xumingming.sinaapp.com/[James Xu])
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 http://www.omnigroup.com/products/omnigraffle/[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 http://www.omnigroup.com/products/omnigraffle/[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/.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/.png`
5. Send me a pull request.
=== Publication
This flowchart is featured in an appendix in http://clojurebook.com[_Clojure Programming_] from O'Reilly, by myself, Christophe Grand, and Brian Carper.
image::http://www.clojurebook.com/cover.png[]
http://cemerick.com/2011/07/05/flowchart-for-choosing-the-right-clojure-type-definition-form[Original Clojure type selection flowchart] © 2011 Chas Emerick