aboutsummaryrefslogtreecommitdiffstats
path: root/guide/erlang_beginners.md
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2013-06-27 00:02:12 +0200
committerLoïc Hoguin <[email protected]>2013-06-27 00:02:12 +0200
commit61ca86b05493f82bcbddd76911fee64dc636c885 (patch)
tree9292e9793840a13204309b982b867b392b4d99df /guide/erlang_beginners.md
parentb059a1237ffb73c91cfe9c1cbf65866cfda3f6c8 (diff)
downloadcowboy-61ca86b05493f82bcbddd76911fee64dc636c885.tar.gz
cowboy-61ca86b05493f82bcbddd76911fee64dc636c885.tar.bz2
cowboy-61ca86b05493f82bcbddd76911fee64dc636c885.zip
Greatly improve the guide introduction
Diffstat (limited to 'guide/erlang_beginners.md')
-rw-r--r--guide/erlang_beginners.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/guide/erlang_beginners.md b/guide/erlang_beginners.md
new file mode 100644
index 0000000..7778dee
--- /dev/null
+++ b/guide/erlang_beginners.md
@@ -0,0 +1,43 @@
+Erlang for beginners
+====================
+
+Chances are you are interested in using Cowboy, but have
+no idea how to write an Erlang program. Fear not! This
+chapter will help you get started.
+
+We recommend two books for beginners. You should read them
+both at some point, as they cover Erlang from two entirely
+different perspectives.
+
+Learn You Some Erlang for Great Good!
+-------------------------------------
+
+The quickest way to get started with Erlang is by reading
+a book with the funny name of [LYSE](http://learnyousomeerlang.com),
+as we affectionately call it.
+
+It will get right into the syntax and quickly answer the questions
+a beginner would ask themselves, all the while showing funny
+pictures and making insightful jokes.
+
+You can read an early version of the book online for free,
+but you really should buy the much more refined paper and
+ebook versions.
+
+Programming Erlang
+------------------
+
+After writing some code, you will probably want to understand
+the very concepts that make Erlang what it is today. These
+are best explained by Joe Armstrong, the godfather of Erlang,
+in his book [Programming Erlang](http://pragprog.com/book/jaerlang2/programming-erlang).
+
+Instead of going into every single details of the language,
+Joe focuses on the central concepts behind Erlang, and shows
+you how they can be used to write a variety of different
+applications.
+
+At the time of writing, the 2nd edition of the book is in beta,
+and includes a few details about upcoming Erlang features that
+cannot be used today. Choose the edition you want, then get
+reading!