From 95d4e89c7ed037a04658b15fbcb7dd2253d8c9f8 Mon Sep 17 00:00:00 2001
From: Amsul <reach@amsul.ca>
Date: Tue, 11 Sep 2012 23:57:36 -0400
Subject: [PATCH 001/105] sidebar scrolls to active page + updated to
 boilerplate v4

---
 _layouts/chapter.html |  14 +-
 _layouts/default.html |  14 +-
 _layouts/recipe.html  |  12 +-
 css/style.css         | 483 ++++++++++++++++++++++++++++--------------
 developers-guide.md   |   2 +-
 js/scripts.js         |  33 +++
 js/tumbleweed.js      |   1 -
 7 files changed, 382 insertions(+), 177 deletions(-)
 create mode 100644 js/scripts.js
 delete mode 100644 js/tumbleweed.js

diff --git a/_layouts/chapter.html b/_layouts/chapter.html
index 7298575..b075d2c 100644
--- a/_layouts/chapter.html
+++ b/_layouts/chapter.html
@@ -76,12 +76,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
-                {% for page in site.pages %}
-                  {% if page.url contains url %}
-                    {% unless page.url == indexurl %}
-                      <li class="list-item recipe"><a class="recipe-title" href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+                {% for site_page in site.pages %}
+                  {% if site_page.url contains url %}
+                    {% unless site_page.url == indexurl %}
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -93,6 +93,8 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
-  </body>
+    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+
+ </body>
 </html>
 
diff --git a/_layouts/default.html b/_layouts/default.html
index 369e873..1f00656 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -73,12 +73,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
-                {% for page in site.pages %}
-                  {% if page.url contains url %}
-                    {% unless page.url == indexurl %}
-                      <li class="list-item recipe"><a class="recipe-title" href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+                {% for site_page in site.pages %}
+                  {% if site_page.url contains url %}
+                    {% unless site_page.url == indexurl %}
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -90,6 +90,8 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
-  </body>
+    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+
+ </body>
 </html>
 
diff --git a/_layouts/recipe.html b/_layouts/recipe.html
index 39ada1a..d71dfba 100644
--- a/_layouts/recipe.html
+++ b/_layouts/recipe.html
@@ -75,12 +75,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
-                {% for page in site.pages %}
-                  {% if page.url contains url %}
-                    {% unless page.url == indexurl %}
-                      <li class="list-item recipe"><a class="recipe-title" href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+                {% for site_page in site.pages %}
+                  {% if site_page.url contains url %}
+                    {% unless site_page.url == indexurl %}
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -92,6 +92,8 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
+    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+
  </body>
 </html>
 
diff --git a/css/style.css b/css/style.css
index 217e53e..138d955 100644
--- a/css/style.css
+++ b/css/style.css
@@ -1,7 +1,8 @@
 /*
   Author:         Amsul - http://github.com/amsul
-  Version:        0.8 beta
-  Last Updated:   28 August, 2012
+  Description:    CoffeeScript Cookbook stylings
+  Version:        1.0
+  Last Updated:   11 September, 2012
 */
 
 
@@ -22,13 +23,22 @@
 
 
 
+/* ========================================================================
+
+    Cross-browser normalize (from HTML5 Boilerplate v4.0)
+
+======================================================================== */
+
+
+
 /*
-    HTML5 element display
+    HTML5 element display (old browsers)
 ======================================================================== */
 
-article, aside, details, figcaption, figure, footer, header, hgroup, nav, section { display: block; }
-audio, canvas, video { display: inline-block; }
-audio:not([controls]) { display: none; }
+article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, summary { display: block; }
+audio, canvas, video { display: inline-block; *display: inline; *zoom: 1; }
+audio:not([controls]) { display: none; height: 0; }
+[hidden] { display: none; }
 
 
 
@@ -38,8 +48,9 @@ audio:not([controls]) { display: none; }
 
 html { font-size: 100%; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; }
 
-body { margin: 0; font-size: 16px; text-align: left; line-height: 1.5; }
-body, button, input, select, textarea { font-family: "Lucida Grande", "Lucida Sans Unicode", sans-serif; font-weight: 200; color: #424242; }
+html, button, input, select, textarea { font-family: "Lucida Grande", "Lucida Sans Unicode", sans-serif; font-weight: 200; color: #424242; }
+
+body { margin: 0; }
 
 
 ::-moz-selection    { background: #b3d4fc; text-shadow: none; }
@@ -52,52 +63,77 @@ body, button, input, select, textarea { font-family: "Lucida Grande", "Lucida Sa
     Links
 ======================================================================== */
 
-a {
-    color: #27ace3;
-    text-decoration: underline;
-}
-
-a:visited {
-}
-
 a:hover,
 a:active {
-    cursor: pointer;
+    outline: 0;
 }
 
 a:focus { outline: thin dotted; }
 
 
+
+
 /*
     Typography
 ======================================================================== */
 
-p, div { word-wrap: break-word; }
+h1 {
+    font-size: 2em;
+    margin: .67em 0;
+}
+
+h2 {
+    font-size: 1.5em;
+    margin: .83em 0;
+}
+
+h3 {
+    font-size: 1.17em;
+    margin: 1em 0;
+}
+
+h4 {
+    font-size: 1em;
+    margin: 1.33em 0;
+}
+
+h5 {
+    font-size: .83em;
+    margin: 1.67em 0;
+}
+
+h6 {
+    font-size: .75em;
+    margin: 2.33em 0;
+}
+
+
+p, div {
+    -ms-word-break: break-all;
+        word-break: break-all;
+        word-break: break-word; /* old webkit */
+}
 
 abbr[title] { border-bottom: 1px dotted; }
 
 b, strong { font-weight: bold; }
 
-blockquote { margin: 1em 0 40px; }
-
-dfn, em { font-style: italic; }
+blockquote { margin: 1em 40px; }
 
-hr { display: block; height: 1px; border: 0; border-top: 1px solid #ccc; margin: 1em 0; padding: 0; }
+dfn { font-style: italic; }
 
-ins { background: #ff9; color: #000; text-decoration: none; }
+mark { background: #ff0; color: #000; }
 
-mark { background: #ff0; color: #000; font-style: italic; font-weight: bold; }
+p, pre { margin: 1em 0; }
 
 pre, code, kbd, samp { font-family: 'Courier', 'Monaco', monospace, serif; font-size: 1em; }
 
-pre { display: table; width: 100%; margin: 0; padding: 24px; }
-
-pre > code { display: block; }
+pre { white-space: pre; white-space: pre-wrap; word-wrap: break-word; }
 
 q { quotes: none; }
 q:before, q:after { content: ""; content: none; }
 
-small { font-size: 85%; }
+small { font-size: 80%; }
 
 sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
 sup { top: -.5em; }
@@ -106,17 +142,22 @@ sub { bottom: -.25em; }
 
 
 
-
 /*
     Lists
 ======================================================================== */
 
-ul, ol { margin: 1em 0; padding: 0 0 0 20px; }
-
-ul { list-style: disc; }
+dl, menu, ol, ul { margin: 1em 0; }
 
 dd { margin: 0 0 0 40px; }
 
+menu, ol, ul { padding: 0 0 0 40px; }
+
+nav ul,
+nav ol {
+    list-style: none;
+    list-style-image: none;
+}
+
 
 
 
@@ -126,7 +167,7 @@ dd { margin: 0 0 0 40px; }
 
 object, embed, img { max-width: 100%; }
 
-img { border: 0; height: auto; vertical-align: middle; -ms-interpolation-mode: bicubic; }
+img { border: 0; -ms-interpolation-mode: bicubic; }
 
 svg:not(:root) { overflow: hidden; }
 
@@ -136,15 +177,7 @@ svg:not(:root) { overflow: hidden; }
     Figures
 ======================================================================== */
 
-figure {
-    margin: 0;
-}
-
-figcaption {
-    line-height: 1.5;
-    padding: 6px 8px;
-    font-size: 12px;
-}
+figure { margin: 0; }
 
 
 
@@ -154,60 +187,48 @@ figcaption {
     Forms
 ======================================================================== */
 
-form {
-    margin: 0;
-}
+form { margin: 0; }
 
 fieldset {
-    border: 0;
-    margin: 0 0 14px;
-    padding: 0;
+    border: 1px solid #c0c0c0;
+    margin: 0 2px;
+    padding: .35em .625em .75em;
 }
 
 legend { border: 0; padding: 0; white-space: normal; }
 
-
-label {
-}
-
-label:hover {
-    cursor: default;
-    color: #27ace3;
-}
+label:hover { cursor: default; }
 
 
 button, input, select, textarea { font-size: 100%; margin: 0; vertical-align: baseline; }
 
-
-button, input { line-height: normal; }
-
-button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
-
-button, input[type=button], input[type=reset], input[type=submit], [role=button] { cursor: pointer; -webkit-appearance: button; }
+button,
+html input[type=button],
+input[type=reset],
+input[type=submit] {
+    -webkit-appearance: button;
+    cursor: pointer;
+}
 
 button[disabled], input[disabled] { cursor: default; }
 
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
 
-input[type=checkbox], input[type=radio] { box-sizing: border-box; cursor: pointer; padding: 0; margin-right: 5px; }
-
-input[type=file] { cursor: pointer; font-size: 11px; color: #555; }
+input[type=checkbox], input[type=radio] {
+    cursor: pointer;
+    padding: 0;
+}
 
 input[type=search] {
     -webkit-appearance: textfield;
-    -webkit-box-sizing: border-box;
-       -moz-box-sizing: border-box;
-            box-sizing: border-box;
+    -webkit-box-sizing: content-box;
+       -moz-box-sizing: content-box;
+            box-sizing: content-box;
 }
 
-
 textarea { overflow: auto; vertical-align: top; resize: vertical; }
 
 
-input:valid, textarea:valid {  }
-
-input:invalid, textarea:invalid { background-color: #f0dddd; }
-
-
 
 
 /*
@@ -216,71 +237,9 @@ input:invalid, textarea:invalid { background-color: #f0dddd; }
 
 table {
     border-spacing: 0;
-    border-collapse: separate;
-    background: #fff;
-    border: 1px solid #ccc;
-    line-height: 1.5;
-
-    -webkit-border-radius: 5px;
-       -moz-border-radius: 5px;
-            border-radius: 5px;
-}
-
-th,
-td {
-    vertical-align: top;
-    padding: 6px 12px;
-    border-top: 1px solid #e2e2e2;
-    border-right: 1px solid #e2e2e2;
-}
-th:last-child,
-td:last-child {
-    border-right: 0;
-}
-
-thead th {
-    background: #f5f5f5;
-    border-top: 0;
-}
-thead th:first-child {
-    -webkit-border-radius: 5px 0 0 0;
-       -moz-border-radius: 5px 0 0 0;
-            border-radius: 5px 0 0 0;
-}
-thead th:last-child {
-    -webkit-border-radius: 0 5px 0 0;
-       -moz-border-radius: 0 5px 0 0;
-            border-radius: 0 5px 0 0;
-}
-
-tbody th,
-tbody td {
-    font-size: 12px;
-}
-
-tbody tr:nth-child(even) th,
-tbody tr:nth-child(even) td {
-    background-color: #f9f9f9;
-}
-
-tbody tr:last-child th:first-child,
-tbody tr:last-child td:first-child {
-    -webkit-border-radius: 0 0 0 5px;
-       -moz-border-radius: 0 0 0 5px;
-            border-radius: 0 0 0 5px;
+    border-collapse: collapse;
 }
 
-tbody tr:last-child th:last-child,
-tbody tr:last-child td:last-child {
-    -webkit-border-radius: 0 0 5px 0;
-       -moz-border-radius: 0 0 5px 0;
-            border-radius: 0 0 5px 0;
-}
-
-
-
-
-
 
 
 
@@ -307,14 +266,45 @@ tbody tr:last-child td:last-child {
 
 
 
-/*
+/* ========================================================================
 
     Primary styling
 
 ======================================================================== */
 
 
-/** Headings **/
+
+/*
+    Base
+======================================================================== */
+
+body {
+    font-size: 16px;
+    line-height: 1.5;
+}
+
+hr {
+    display: block;
+    height: 1px;
+    border: 0;
+    border-top: 1px solid #ccc;
+    margin: 1em 0;
+    padding: 0;
+}
+
+img {
+    vertical-align: middle;
+    height: auto;
+    max-width: 100%;
+}
+
+a {
+    cursor: pointer;
+    text-decoration: underline;
+    color: #27ace3;
+}
+
+
 
 h1,
 h2,
@@ -323,7 +313,7 @@ h4,
 h5,
 h6 {
     font-weight: bold;
-    line-height: 1;
+    line-height: 1.2;
 }
 
 h1:first-child,
@@ -402,6 +392,110 @@ ul.plain-list,
 
 
 
+/*
+    Tables
+======================================================================== */
+
+table {
+    background: #fff;
+    border: 1px solid #ccc;
+    line-height: 1.5;
+
+    -webkit-border-radius: 5px;
+       -moz-border-radius: 5px;
+            border-radius: 5px;
+}
+
+th,
+td {
+    vertical-align: top;
+    padding: 6px 12px;
+    border-top: 1px solid #e2e2e2;
+    border-right: 1px solid #e2e2e2;
+}
+th:last-child,
+td:last-child {
+    border-right: 0;
+}
+
+thead th {
+    background: #f5f5f5;
+    border-top: 0;
+}
+thead th:first-child {
+    -webkit-border-radius: 5px 0 0 0;
+       -moz-border-radius: 5px 0 0 0;
+            border-radius: 5px 0 0 0;
+}
+thead th:last-child {
+    -webkit-border-radius: 0 5px 0 0;
+       -moz-border-radius: 0 5px 0 0;
+            border-radius: 0 5px 0 0;
+}
+
+tbody th,
+tbody td {
+    font-size: 12px;
+}
+
+tbody tr:nth-child(even) th,
+tbody tr:nth-child(even) td {
+    background-color: #f9f9f9;
+}
+
+tbody tr:last-child th:first-child,
+tbody tr:last-child td:first-child {
+    -webkit-border-radius: 0 0 0 5px;
+       -moz-border-radius: 0 0 0 5px;
+            border-radius: 0 0 0 5px;
+}
+
+tbody tr:last-child th:last-child,
+tbody tr:last-child td:last-child {
+    -webkit-border-radius: 0 0 5px 0;
+       -moz-border-radius: 0 0 5px 0;
+            border-radius: 0 0 5px 0;
+}
+
+
+
+
+/*
+    Form elements
+======================================================================== */
+
+fieldset {
+    border: 0;
+    margin: 0 0 14px;
+    padding: 0;
+}
+
+
+input[type=checkbox],
+input[type=radio] {
+    margin-right: 5px;
+}
+
+label:hover {
+    color: #27ace3;
+}
+
+
+
+
+/*
+    Code blocks
+======================================================================== */
+
+pre { display: table; width: 100%; margin: 0; padding: 24px; }
+
+pre > code { display: block; }
+
+
+
+
+
+
 
 
 
@@ -412,7 +506,8 @@ ul.plain-list,
 
 .container {
     margin-left: 444px;
-    min-width: 640px;
+    min-width: 666px;
+    max-width: 1000px;
     padding: 40px;
 
     -webkit-box-sizing: border-box;
@@ -601,6 +696,39 @@ ul.plain-list,
 
 
 
+/*
+    Active page
+======================================================================== */
+
+.page-active {
+    position: relative;
+    background: #fff;
+    padding-right: 24px;
+
+    -webkit-border-radius: 2px;
+       -moz-border-radius: 2px;
+            border-radius: 2px;
+}
+
+.page-active:after {
+    content: 'M';
+    position: absolute;
+    top: 4px;
+    right: 0;
+    font-family: 'Entypo';
+    font-size: 36px;
+    line-height: 6px;
+    color: #666;
+}
+
+.recipes-list .page-active:after {
+    top: 1px;
+}
+
+
+
+
+
 
 
 
@@ -633,9 +761,9 @@ ul.plain-list,
 
 
 .hidden { display: none; visibility: hidden; }
-
 .invisible { visibility: hidden; }
 
+
 .thin { font-weight: 100; }
 
 .entypo {
@@ -649,12 +777,23 @@ ul.plain-list,
 .alignright { float: right; }
 
 
-.clear:before, .clear:after { content: ""; display: table; }
+.clear:before, .clear:after { content: " "; display: table; }
 .clear:after { clear: both; }
-.clear { zoom: 1; }
+.clear { *zoom: 1; }
 
 
-.ir { border: 0; font: 0/0 a; text-shadow: none; color: transparent; background-color: transparent; }
+.ir {
+    background-color: transparent;
+    border: 0;
+    overflow: hidden;
+    *text-indent: -9999px;
+}
+.ir:before {
+    content: "";
+    display: block;
+    width: 0;
+    height: 100%;
+}
 
 
 
@@ -759,6 +898,28 @@ green:     #859900;
 
 
 
+/* ==========================================================================
+
+    Media Queries
+
+========================================================================== */
+
+@media (max-width: 1110px) {
+
+    body:after {
+        content: 'narrow';
+        display: none;
+    }
+
+    #sidebar {
+        position: absolute;
+        bottom: auto;
+        border-bottom: 1px solid #e0e5e6;
+    }
+
+}
+
+
 
 
 
@@ -768,18 +929,24 @@ green:     #859900;
     Print media queries
 ======================================================================== */
 
-
 @media print {
-    * { background: transparent !important; color: black !important; box-shadow:none !important; text-shadow: none !important; } /* Black prints faster: h5bp.com/s */
-    a, a:visited { text-decoration: underline; }
-    a[href]:after { content: " (" attr(href) ")"; }
-    abbr[title]:after { content: " (" attr(title) ")"; }
-    .ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; } /* Don't show links for images, or javascript/internal links */
-    pre, blockquote { border: 1px solid #999; page-break-inside: avoid; }
-    thead { display: table-header-group; } /* h5bp.com/t */
-    tr, img { page-break-inside: avoid; }
-    img { max-width: 100% !important; }
-    @page { margin: 0.5cm; }
-    p, h2, h3 { orphans: 3; widows: 3; }
-    h2, h3 { page-break-after: avoid; }
+    * {
+        background: transparent !important;
+        color: #000 !important;
+        box-shadow:none !important;
+        text-shadow: none !important;
+    }
+    a, a:visited { text-decoration: underline; }
+    a[href]:after { content: " (" attr(href) ")"; }
+    abbr[title]:after { content: " (" attr(title) ")"; }
+    .ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; }
+    pre, blockquote { border: 1px solid #999; page-break-inside: avoid; }
+    thead { display: table-header-group; }
+    tr, img { page-break-inside: avoid; }
+    img { max-width: 100% !important; }
+    @page { margin: 0.5cm; }
+    p, h2, h3 { orphans: 3; widows: 3; }
+    h2, h3 { page-break-after: avoid; }
 }
+
+
diff --git a/developers-guide.md b/developers-guide.md
index 484a7e0..8d8c210 100644
--- a/developers-guide.md
+++ b/developers-guide.md
@@ -67,6 +67,6 @@ serve
 
 This will start a webserver in the `_site` folder. Open a browser and visit `http://localhost:4000/` and you should see the site.
 
-## Minituiae and Other Trivialities
+## Minutiae and Other Trivialities
 
 jekyll can take a second or two to catch up when you save a file. If you edit a file and don't see the changes in your browser, give it a second or two and try again. You may also see Maruku warnings, but as long as it prints `Successfully generated site` you should be alright.
diff --git a/js/scripts.js b/js/scripts.js
new file mode 100644
index 0000000..42e30b8
--- /dev/null
+++ b/js/scripts.js
@@ -0,0 +1,33 @@
+
+/*jshint browser: true, devel: true, debug: true */
+
+
+(function( window, document, undefined ) {
+
+    var activePage, position, sidebar,
+        narrowScreen = ( window.getComputedStyle( document.body, ':after' ).getPropertyValue( 'content' ) === 'narrow' ) ? true : false
+
+
+    // if it's not the index page and not a narrow screen
+    if ( window.location.pathname.length && !narrowScreen ) {
+
+        // get the sidebar
+        sidebar = document.getElementById( 'sidebar' )
+
+        // query the dom for the active page
+        activePage = document.getElementsByClassName( 'page-active' )
+
+        // if an active page was found
+        if ( activePage.length ) {
+
+            // get the offset position and give a padding of 80px
+            position = activePage[0].offsetTop - 80
+
+            // set the scroll position of the sidebar to the new position
+            sidebar.scrollTop = position
+        }
+    }
+
+
+})( window, document )
+
diff --git a/js/tumbleweed.js b/js/tumbleweed.js
deleted file mode 100644
index 2b933b8..0000000
--- a/js/tumbleweed.js
+++ /dev/null
@@ -1 +0,0 @@
-// tumbleweed.js - nothing to see here, podner.

From 892921318b6aaec945a5ed6f24e74b1fde40c146 Mon Sep 17 00:00:00 2001
From: nicoder <nicolas.dermine@gmail.com>
Date: Wed, 12 Sep 2012 22:59:02 +0300
Subject: [PATCH 002/105] Fixed typo

---
 chapters/syntax/embedding_javascript.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/syntax/embedding_javascript.md b/chapters/syntax/embedding_javascript.md
index 4b5d446..69d386c 100644
--- a/chapters/syntax/embedding_javascript.md
+++ b/chapters/syntax/embedding_javascript.md
@@ -23,7 +23,7 @@ greet "Coffee"
 
 ## Discussion
 
-This is a simple way to integrate small snippets of JavaScript code into your CoffeeScript without converting it over to use CoffeeScript syntax. As shown in the [CoffeeScript Language Reference](http://jashkenas.github.com/coffee-script/#embedded) you can mix to the two languages to a certain extent:
+This is a simple way to integrate small snippets of JavaScript code into your CoffeeScript without converting it over to use CoffeeScript syntax. As shown in the [CoffeeScript Language Reference](http://jashkenas.github.com/coffee-script/#embedded) you can mix the two languages to a certain extent:
 
 {% highlight coffeescript %}
 hello = `function (name) {

From 3f2895a6e5bb2d32599fc4aeb34b066a7bb08939 Mon Sep 17 00:00:00 2001
From: Amsul <reach@amsul.ca>
Date: Wed, 12 Sep 2012 23:39:17 -0400
Subject: [PATCH 003/105] added recipe for checking type of value is array

---
 chapters/arrays/check-type-is-array.md | 44 ++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 chapters/arrays/check-type-is-array.md

diff --git a/chapters/arrays/check-type-is-array.md b/chapters/arrays/check-type-is-array.md
new file mode 100644
index 0000000..1206ef1
--- /dev/null
+++ b/chapters/arrays/check-type-is-array.md
@@ -0,0 +1,44 @@
+---
+layout: recipe
+title: Check if type of value is an Array
+chapter: Arrays
+---
+## Problem
+
+You want to check if a value is an `Array`.
+
+{% highlight coffeescript %}
+myArray = []
+console.log typeof myArray // outputs 'object'
+{% endhighlight %}
+
+The `typeof` operator gives a faulty output for arrays.
+
+## Solution
+
+Use the following code:
+
+{% highlight coffeescript %}
+typeIsArray = Array.isArray || ( value ) -> return {}.toString.call( value ) is '[object Array]'
+{% endhighlight %}
+
+To use this, just call `typeIsArray` as such:
+
+{% highlight coffeescript %}
+myArray = []
+typeIsArray myArray // outputs true
+{% endhighlight %}
+
+## Discussion
+
+The method above has been adopted from "the Miller Device". An alternative is to use Douglas Crockford's snippet:
+
+{% highlight coffeescript %}
+typeIsArray = ( value ) ->
+    value and
+        typeof value is 'object' and
+        value instanceof Array and
+        typeof value.length is 'number' and
+        typeof value.splice is 'function' and
+        not ( value.propertyIsEnumerable 'length' )
+{% endhighlight %}

From b2bcb002bd880d6cea078c693cd9f59cdad2fb2c Mon Sep 17 00:00:00 2001
From: Scott Carleton <scott@artsicle.com>
Date: Thu, 13 Sep 2012 19:29:49 -0400
Subject: [PATCH 004/105] instance method example for clarification

---
 .../class-methods-and-instance-methods.md     | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/chapters/classes_and_objects/class-methods-and-instance-methods.md b/chapters/classes_and_objects/class-methods-and-instance-methods.md
index 53977a6..492f0b9 100644
--- a/chapters/classes_and_objects/class-methods-and-instance-methods.md
+++ b/chapters/classes_and_objects/class-methods-and-instance-methods.md
@@ -9,6 +9,7 @@ You want to create a class methods and instance methods.
 
 ## Solution
 
+### Class Method
 {% highlight coffeescript %}
 class Songs
   @_titles: 0    # Although it's directly accessible, the leading _ defines it by convention as private property.
@@ -30,6 +31,25 @@ song.get_count()
 # => TypeError: Object #<Songs> has no method 'get_count'
 {% endhighlight %}
 
+### Instance Method
+class Songs
+  _titles: 0    # Although it's directly accessible, the leading _ defines it by convention as private property.
+
+  get_count: ->
+    @_titles
+
+  constructor: (@artist, @title) ->
+    @_titles++
+
+song = new Songs("Rick Astley", "Never Gonna Give You Up")
+song.get_count()
+# => 1
+
+Songs.get_count()
+# => TypeError: Object function Songs(artist, title) ... has no method 'get_count'
+{% endhighlight %}
+
+
 ## Discussion
 
 Coffeescript will store class methods (also called static methods) on the object itself rather than on the object prototype (and thus on individual object instances), which conserves memory and gives a central location to store class-level values.

From d6c64d8a98de68294aa29434f1a6fcbcffffbf2a Mon Sep 17 00:00:00 2001
From: Scott Carleton <scott@artsicle.com>
Date: Fri, 14 Sep 2012 10:33:18 -0400
Subject: [PATCH 005/105] fixed coffeescript highlighting

---
 Gemfile.lock                                              | 2 +-
 .../class-methods-and-instance-methods.md                 | 8 +++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Gemfile.lock b/Gemfile.lock
index 8b54f2a..0b46357 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,7 +1,7 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    RedCloth (4.2.7)
+    RedCloth (4.2.9)
     activesupport (3.0.7)
     classifier (1.3.3)
       fast-stemmer (>= 1.0.0)
diff --git a/chapters/classes_and_objects/class-methods-and-instance-methods.md b/chapters/classes_and_objects/class-methods-and-instance-methods.md
index 492f0b9..36960b3 100644
--- a/chapters/classes_and_objects/class-methods-and-instance-methods.md
+++ b/chapters/classes_and_objects/class-methods-and-instance-methods.md
@@ -10,7 +10,9 @@ You want to create a class methods and instance methods.
 ## Solution
 
 ### Class Method
+
 {% highlight coffeescript %}
+
 class Songs
   @_titles: 0    # Although it's directly accessible, the leading _ defines it by convention as private property.
 
@@ -28,10 +30,13 @@ Songs.get_count()
 # => 1
 
 song.get_count()
-# => TypeError: Object #<Songs> has no method 'get_count'
+# => TypeError: Object <Songs> has no method 'get_count'
+
 {% endhighlight %}
 
 ### Instance Method
+{% highlight coffeescript %}
+
 class Songs
   _titles: 0    # Although it's directly accessible, the leading _ defines it by convention as private property.
 
@@ -47,6 +52,7 @@ song.get_count()
 
 Songs.get_count()
 # => TypeError: Object function Songs(artist, title) ... has no method 'get_count'
+
 {% endhighlight %}
 
 

From 80f34cf476397acb48eef854c89221242a8dd9e6 Mon Sep 17 00:00:00 2001
From: Vinny Diehl <gbchaosmaster926@gmail.com>
Date: Sat, 13 Oct 2012 18:17:46 -0400
Subject: [PATCH 006/105] Wrap whole words

Wrapping words at characters is seriously nasty.
---
 css/style.css | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/css/style.css b/css/style.css
index 138d955..9caf5c6 100644
--- a/css/style.css
+++ b/css/style.css
@@ -107,13 +107,6 @@ h6 {
     margin: 2.33em 0;
 }
 
-
-p, div {
-    -ms-word-break: break-all;
-        word-break: break-all;
-        word-break: break-word; /* old webkit */
-}
-
 abbr[title] { border-bottom: 1px dotted; }
 
 b, strong { font-weight: bold; }

From e19a815b27ac09924d039f86e315c143b7701fee Mon Sep 17 00:00:00 2001
From: Paul Masurel <paul.masurel@gmail.com>
Date: Tue, 6 Nov 2012 15:06:21 +0100
Subject: [PATCH 007/105] Update chapters/arrays/zip-function.md

Using the max length of the list arguments does not match python
specification of zip. I guess that's ok if we make the behavior in this
boundary case clear.
---
 chapters/arrays/zip-function.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/arrays/zip-function.md b/chapters/arrays/zip-function.md
index f2a1091..bf1dfca 100644
--- a/chapters/arrays/zip-function.md
+++ b/chapters/arrays/zip-function.md
@@ -15,7 +15,7 @@ Use the following CoffeeScript code:
 # Usage: zip(arr1, arr2, arr3, ...)
 zip = () ->
   lengthArray = (arr.length for arr in arguments)
-  length = Math.max(lengthArray...)
+  length = Math.min(lengthArray...)
   for i in [0...length]
     arr[i] for arr in arguments
 

From c9d17ba1ff71ec72e9546afc20759a0573566e47 Mon Sep 17 00:00:00 2001
From: onlyjsmith <jonathan@impacti.org>
Date: Fri, 23 Nov 2012 10:18:14 +0000
Subject: [PATCH 008/105] Solution was giving wrong answer
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Have tested this in Chrome 23, Firefox 17 and Opera 12.

This SO page also relates http://stackoverflow.com/questions/222309/calculate-last-day-of-month-in-javascript
---
 chapters/dates_and_times/finding-last-day-of-the-month.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/chapters/dates_and_times/finding-last-day-of-the-month.md b/chapters/dates_and_times/finding-last-day-of-the-month.md
index c054afd..98ccec6 100644
--- a/chapters/dates_and_times/finding-last-day-of-the-month.md
+++ b/chapters/dates_and_times/finding-last-day-of-the-month.md
@@ -13,9 +13,9 @@ Use JavaScript's Date underflow to find the -1th day of the following month:
 
 {% highlight coffeescript %}
 now = new Date
-lastDayOfTheMonth = new Date(1900+now.getYear(), now.getMonth()+1, -1)
+lastDayOfTheMonth = new Date(1900+now.getYear(), now.getMonth()+1, 0)
 {% endhighlight %}
 
 ## Discussion
 
-JavaScript's Date constructor cheerfully handles overflow and underflow conditions, which makes date math very easy. Given this ease of manipulation, it doesn't make sense to worry about how many days are in a given month; just nudge the math around. In December, the solution above will actually ask for the -1th day of the 13th month of the current year, which works out to the -1th day of January of NEXT year, which works out to the 31st day of December of the current year.
+JavaScript's Date constructor cheerfully handles overflow and underflow conditions, which makes date math very easy. Given this ease of manipulation, it doesn't make sense to worry about how many days are in a given month; just nudge the math around. In December, the solution above will actually ask for the 0th day of the 13th month of the current year, which works out to the day before the 1st day of January of NEXT year, which works out to the 31st day of December of the current year.

From 12d5623d7ebfa5b9875577a272ba372f1b906434 Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Wed, 26 Dec 2012 17:18:37 -0500
Subject: [PATCH 009/105] Refactors the code in the singlton design pattern

The original code was a little misleading and it also would compile with
a runtime error.

This offers a new version that illistrates the use of closures inside a
class definition. It also provides an example of how to handle modules
(including private classes) The two example together illistrate some of
the flexability and elegance CoffeeScript can offer. It also explains
how the use of the wrapper around a CS file.
---
 chapters/design_patterns/singleton.md | 96 ++++++++++++++++-----------
 1 file changed, 56 insertions(+), 40 deletions(-)

diff --git a/chapters/design_patterns/singleton.md b/chapters/design_patterns/singleton.md
index 4f40859..18bbf27 100644
--- a/chapters/design_patterns/singleton.md
+++ b/chapters/design_patterns/singleton.md
@@ -7,59 +7,75 @@ chapter: Design Patterns
 
 Many times you only want one, and only one, instance of a class. For example, you may only need one class that creates server resources and you want to ensure that the one object can control those resources. Beware, however, because the singleton pattern can be easily abused to mimic unwanted global variables.
 
+
 ## Solution
 
 The publicly available class only contains the method to get the one true instance. The instance is kept within the closure of that public object and is always returned.
 
-The actual definition of the singleton class follows.
+This is works because CoffeeScript allows you to define executable statements inside a class definition. However, because most CoffeeScript compiles into a [IIFE][] wrapper you do not have to place the private class inside the class definition if this style suits you. The later might be useful when developing modular code such as found in [CommonJS][] (Node.js) or [Require.js][] (See the discussion for an example).
 
-Note that I am using the idiomatic module export feature to emphasize the publicly accessible portion of the module. Remember coffeescript wraps all files in a function block to protect the global namespace.
+[IIFE]: http://benalman.com/news/2010/11/immediately-invoked-function-expression/
+[CommonJS]: http://www.commonjs.org/
+[Require.js]: http://requirejs.org/
 
 {% highlight coffeescript %}
-root = exports ? this # http://stackoverflow.com/questions/4214731/coffeescript-global-variables
-
-# The publicly accessible Singleton fetcher
-class root.Singleton
-  _instance = undefined # Must be declared here to force the closure on the class
-  @get: (args) -> # Must be a static method
-    _instance ?= new _Singleton args
-
-# The actual Singleton class
-class _Singleton
-  constructor: (@args) ->
-
-  echo: ->
-    @args
-
-a = root.Singleton.get 'Hello A'
-a.echo()
-# => 'Hello A'
-
-b = root.Singleton.get 'Hello B'
-a.echo()
-# => 'Hello A'
+class Singleton
+  # You can add statements inside the class definition
+  # which helps establish private scope (due to closures)
+  # instance is defined as null to force correct scope
+  instance = null
+  # Create a private class that we can initialize however
+  # defined inside this scope to force the use of the
+  # singleton class.
+  class PrivateClass
+    constructor: (@message) ->
+    echo: -> @message
+  # This is a static method used to either retrieve the
+  # instance or create a new one.
+  @get: (message) ->
+    instance ?= new PrivateClass(message)
+
+a = Singleton.get "Hello A"
+a.echo() # => "Hello A"
+
+b = Singleton.get "Hello B"
+b.echo() # => "Hello A"
+
+Singleton.instance # => undefined
+a.instance # => undefined
+Singleton.PrivateClass # => undefined
+{% endhighlight %}
 
-b.echo()
-# => 'Hello A'
 
-root.Singleton._instance
-# => undefined
+## Discussion
 
-root.Singleton._instance = 'foo'
+See in the above example how all instances are outputting from the same instance of the Singleton class. You can also see that the PrivateClass and instance variable are not accessible outside the Singleton class. In essance the Singleton class provides a static method get which returns only one instance of PrivateClass and only one. It also hides the PrivateClass from the world so that you can not create your own.
 
-root.Singleton._instance
-# => 'foo'
+The idea of hiding or making private the inner workings is preference. Especially since by default CoffeeScript wraps the compiled code inside it's own IIFE (closure) allowing you to define classes without worry that it might be accessible from outside the file. In this example, note that I am using the idiomatic module export feature to emphasize the publicly accessible portion of the module. (See this discussion for further explanation on [exporting to the global namespace][1]).
 
-c = root.Singleton.get 'Hello C'
-c.foo()
-# => 'Hello A'
+[1]: http://stackoverflow.com/questions/4214731/coffeescript-global-variables
 
-a.foo()
-# => 'Hello A'
+{% highlight coffeescript %}
+root = exports ? this
+
+# Create a private class that we can initialize however
+# defined inside the wrapper scope.
+class ProtectedClass
+  constructor: (@message) ->
+  echo: -> @message
+
+class Singleton
+  # You can add statements inside the class definition
+  # which helps establish private scope (due to closures)
+  # instance is defined as null to force correct scope
+  instance = null
+  # This is a static method used to either retrieve the
+  # instance or create a new one.
+  @get: (message) ->
+    instance ?= new ProtectedClass(message)
+
+# Export Singleton as a module
+root.Singleton = Singleton
 {% endhighlight %}
 
-## Discussion
-
-See in the above example how all instances are outputting from the same instance of the Singleton class.
-
 Note how incredibly simple coffeescript makes this design pattern. For reference and discussion on nice javascript implementations, check out [Essential JavaScript Design Patterns For Beginners](http://addyosmani.com/resources/essentialjsdesignpatterns/book/).

From aa07fbd7132b6aa0893908c64d2ad36d54fe6e06 Mon Sep 17 00:00:00 2001
From: Kolja <kolja@apfel.de>
Date: Fri, 18 Jan 2013 12:28:59 +0100
Subject: [PATCH 010/105] Update chapters/jquery/plugin.md

---
 chapters/jquery/plugin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/jquery/plugin.md b/chapters/jquery/plugin.md
index 481d00e..df95cf1 100644
--- a/chapters/jquery/plugin.md
+++ b/chapters/jquery/plugin.md
@@ -46,7 +46,7 @@ Here are a couple of examples of how to use your new plugin.
 {% highlight javascript %}
 $("body").pluginName({
   debug: true
-};
+});
 
 {% endhighlight %}
 

From 19d514dfd3cd7096bd42b7c106c70ed2009f1c74 Mon Sep 17 00:00:00 2001
From: wangyang <BlackTea1988@gmail.com>
Date: Wed, 30 Jan 2013 10:42:11 +0800
Subject: [PATCH 011/105] fix bug

1."Math.min l1, l2 == 0" is equivalent to "Math.min(l1, (l2 == 0))".I
think this is not the author would like to express.
2."[0...l1 + 1]" is equivalent to "[0..l1]".
---
 chapters/strings/matching-strings.md | 87 ++++++++++++++--------------
 1 file changed, 42 insertions(+), 45 deletions(-)

diff --git a/chapters/strings/matching-strings.md b/chapters/strings/matching-strings.md
index 100aefa..ecc18a0 100644
--- a/chapters/strings/matching-strings.md
+++ b/chapters/strings/matching-strings.md
@@ -1,45 +1,42 @@
----
-layout:   recipe
-title:    Matching Strings
-chapter:  Strings
----
-## Problem
-
-You want to match two or more strings.
-
-## Solution
-
-Calculate the edit distance, or number of operations required to transform one string into the other.
-
-{% highlight coffeescript %}
-
-Levenshtein =
-  (str1, str2) ->
-         
-    l1 = str1.length
-    l2 = str2.length
-
-    Math.max l1, l2 if Math.min l1, l2 == 0      
-
-    i = 0; j = 0; distance = []
-
-    for i in [0...l1 + 1]
-     distance[i] = []
-     distance[i][0] = i
-
-    distance[0][j] = j for j in [0...l2 + 1]
-
-    for i in [1...l1 + 1]
-     for j in [1...l2 + 1]
-       distance[i][j] = Math.min distance[i - 1][j] + 1,
-         distance[i][j - 1] + 1,                         
-         distance[i - 1][j - 1] + 
-           if (str1.charAt i - 1) == (str2.charAt j - 1) then 0 else 1
-
-    distance[l1][l2]
-    
-{% endhighlight %}
-
-## Discussion
-
-You can use either Hirschberg or Wagner–Fischer's algorithm to calculate a Levenshtein distance. This example uses Wagner–Fischer's algorithm.
+---
+layout:   recipe
+title:    Matching Strings
+chapter:  Strings
+---
+## Problem
+
+You want to match two or more strings.
+
+## Solution
+
+Calculate the edit distance, or number of operations required to transform one string into the other.
+
+{% highlight coffeescript %}
+
+Levenshtein =
+  (str1, str2) ->
+         
+    l1 = str1.length
+    l2 = str2.length
+
+    return Math.max l1, l2 unless l1 and l2
+
+    i = 0; j = 0; distance = []
+
+    distance[i] = [i] for i in [0..l1]
+    distance[0][j] = j for j in [0..l2]
+
+    for i in [1..l1]
+     for j in [1..l2]
+       distance[i][j] = Math.min distance[i - 1][j] + 1,
+         distance[i][j - 1] + 1,                         
+         distance[i - 1][j - 1] + 
+           if (str1.charAt i - 1) is (str2.charAt j - 1) then 0 else 1
+
+    distance[l1][l2]
+    
+{% endhighlight %}
+
+## Discussion
+
+You can use either Hirschberg or Wagner–Fischer's algorithm to calculate a Levenshtein distance. This example uses Wagner–Fischer's algorithm.

From c94b78a51873d6dcf66370182c69c434fe51486f Mon Sep 17 00:00:00 2001
From: Paul Masurel <paul.masurel@gmail.com>
Date: Thu, 31 Jan 2013 02:08:01 +0100
Subject: [PATCH 012/105] Levenshtein, programming style
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The version before this commit was I believe correct.
I would therefore totally understand if this pull request was rejected.

However I think levenshtein provides a very nice example to demonstrate
some of the functionality and pitfalls of coffeescript.

First I am not too fond of the "return unless" statement. It
feels a bit uncanny to find a non indented return in the middle
of a function.

Most important I am not fond of what this statement is trying to hide. In
most languages, checking for the empty string is not useful. 

see Discussion section.
---
 chapters/strings/matching-strings.md | 43 ++++++++++++++++------------
 1 file changed, 25 insertions(+), 18 deletions(-)

diff --git a/chapters/strings/matching-strings.md b/chapters/strings/matching-strings.md
index ecc18a0..1f16f05 100644
--- a/chapters/strings/matching-strings.md
+++ b/chapters/strings/matching-strings.md
@@ -13,30 +13,37 @@ Calculate the edit distance, or number of operations required to transform one s
 
 {% highlight coffeescript %}
 
-Levenshtein =
-  (str1, str2) ->
-         
+  levenshtein = (str1, str2) ->
+    
     l1 = str1.length
     l2 = str2.length
+    prevDist = [0..l2]
+    nextDist = [0..l2]
+
+    for i in [1..l1] by 1
+      nextDist[0] = i
+      for j in [1..l2] by 1
+        if (str1.charAt i-1) == (str2.charAt j-1)
+          nextDist[j] = prevDist[j-1]
+        else
+          nextDist[j] = 1 + Math.min prevDist[j], nextDist[j-1], prevDist[j-1]
+        [prevDist,nextDist]=[nextDist, prevDist]
+    
+    prevDist[l2]
 
-    return Math.max l1, l2 unless l1 and l2
+{% endhighlight %}
 
-    i = 0; j = 0; distance = []
+## Discussion
 
-    distance[i] = [i] for i in [0..l1]
-    distance[0][j] = j for j in [0..l2]
+You can use either Hirschberg or Wagner–Fischer's algorithm to calculate a Levenshtein distance. This example uses Wagner–Fischer's algorithm.
 
-    for i in [1..l1]
-     for j in [1..l2]
-       distance[i][j] = Math.min distance[i - 1][j] + 1,
-         distance[i][j - 1] + 1,                         
-         distance[i - 1][j - 1] + 
-           if (str1.charAt i - 1) is (str2.charAt j - 1) then 0 else 1
+This version of Levenshtein algorithm is linear in memory, quadratic in time.
 
-    distance[l1][l2]
-    
-{% endhighlight %}
+str.charAt i is preferred here to str[i] because the latter syntax is not supported by some browsers (e.g. IE7).
 
-## Discussion
+At first glance the use of "by 1" in the two loops might look useless. It is actually here to avoid a common danger 
+of the coffeescript [i..j] syntax. If str1 or str2 is an empty string, then [1..l1] or [1..l2] will return [1,0].
+The loops with the "by 1" statement also compiles to cleaner / slightly more performant javascript.
 
-You can use either Hirschberg or Wagner–Fischer's algorithm to calculate a Levenshtein distance. This example uses Wagner–Fischer's algorithm.
+Finally the optimization of recycling of arrays at the end of the loops is mainly here to
+demonstrate the syntax of coffeescript for swapping two variables.

From 3565f28456775cfec79e770f1e728601a9b93f21 Mon Sep 17 00:00:00 2001
From: ZhiCun <island205@gmail.com>
Date: Thu, 31 Jan 2013 13:49:34 +0800
Subject: [PATCH 013/105] spelling mistake

the `function` in "You'd like to know the type of a function without using typeof. " must be `object`.
---
 chapters/classes_and_objects/type-function.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/classes_and_objects/type-function.md b/chapters/classes_and_objects/type-function.md
index 6a7f9b8..42952ac 100644
--- a/chapters/classes_and_objects/type-function.md
+++ b/chapters/classes_and_objects/type-function.md
@@ -5,7 +5,7 @@ chapter: Classes and Objects
 ---
 ## Problem
 
-You'd like to know the type of a function without using typeof. (See http://javascript.crockford.com/remedial.html for more information on why typeof is pretty inferior.)
+You'd like to know the type of a object without using typeof. (See http://javascript.crockford.com/remedial.html for more information on why typeof is pretty inferior.)
 
 ## Solution
 

From f1d710e78ca0dde34a3bffb265bc93125e9689f4 Mon Sep 17 00:00:00 2001
From: "derek.lee" <derek.lee@gmail.com>
Date: Mon, 25 Feb 2013 21:06:20 -0700
Subject: [PATCH 014/105] Added a line break to the ajax call so "error:" would
 be on it's own line.

---
 chapters/jquery/ajax.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/chapters/jquery/ajax.md b/chapters/jquery/ajax.md
index e5563fa..97d0769 100644
--- a/chapters/jquery/ajax.md
+++ b/chapters/jquery/ajax.md
@@ -25,7 +25,8 @@ $(document).ready ->
 	# Advanced Settings
 	$.ajax '/',
 		type: 'GET'
-		dataType: 'html' error: (jqXHR, textStatus, errorThrown) ->
+		dataType: 'html'
+		error: (jqXHR, textStatus, errorThrown) ->
 			$('body').append "AJAX Error: #{textStatus}"
 		success: (data, textStatus, jqXHR) ->
 			$('body').append "Successful AJAX call: #{data}"

From fa13f3bd8ee0eaffe05a721c00b0707b9d41484b Mon Sep 17 00:00:00 2001
From: d8uv <github@d8uv.org>
Date: Thu, 28 Feb 2013 11:03:08 -0900
Subject: [PATCH 015/105] Change the shuffle to the Fisher-Yates shuffle
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The current "Shuffling Array Elements" page recommends a naive algorithm, which produces 
a slow and biased shuffle. Included is a highly idiomatic refactorization of the Fisher-
Yates shuffle (aka the Knuth Shuffle), a less-idiomatic-but-better refactorization, and a
version of the algorithm that adds to Array.prototype, for those that program in that 
style.
---
 chapters/arrays/shuffling-array-elements.md | 87 +++++++++++++++++++--
 1 file changed, 82 insertions(+), 5 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 9f2f8e9..7963ac4 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -9,17 +9,94 @@ You want to shuffle the elements in an array.
 
 ## Solution
 
-The JavaScript Array `sort()` method accepts a custom sort function. We can write a `shuffle()` method to add some convenience.
+The [Fisher-Yates shuffle] is a highly efficient and completely unbiased way to randomize
+the elements in an array. It's a fairly simple method: Start at the end of the list, and
+swap the last element with a random element from earlier in the list. Go down one and 
+repeat, until you're at the beginning of the list, with all of the shuffled elements 
+at the end of the list. This [Fisher-Yates shuffle Visualization] may help you understand
+the algorithm.
 
 {% highlight coffeescript %}
-Array::shuffle = -> @sort -> 0.5 - Math.random()
+shuffle = (a) ->
+  # From the end of the list to the beginning, pick element `i`.
+  for i in [a.length-1..1]
+    # Choose random element `j` to the front of `i` to swap with.
+    j = Math.floor Math.random() * (i + 1)
+    # Swap `j` with `i`, using destructured assignment
+    [a[i], a[j]] = [a[j], a[i]]
+  # Return the shuffled array.
+  a
 
-[1..9].shuffle()
+shuffle([1..9])
 # => [ 3, 1, 5, 6, 4, 8, 2, 9, 7 ]
 {% endhighlight %}
 
+[Fisher-Yates shuffle]: http://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+[Fisher-Yates Shuffle Visualization]: http://bost.ocks.org/mike/shuffle/
+
 ## Discussion
 
-For more background on how this shuffle logic works, see this [discussion at StackOverflow](http://stackoverflow.com/questions/962802/is-it-correct-to-use-javascript-array-sort-method-for-shuffling).
+### The Wrong Way to do it
+
+There is a common--but terribly wrong way--to shuffle an array, by sorting by a random
+number.
+
+{% highlight coffeescript %}
+shuffle = (a) -> a.sort -> 0.5 - Math.random()
+{% endhighlight %}
+
+If you do a sort randomly, it should give you a random order, right? Even [Microsoft used 
+this random-sort algorithm][msftshuffle]. Turns out, [this random-sort algorithm produces
+biased results][naive], because it only has the illusion of shuffling. Randomly sorting
+will not result in a neat, tidy shuffle; it will result in a wild mass of inconsistent
+sorting.
+
+[msftshuffle]: http://www.robweir.com/blog/2010/02/microsoft-random-browser-ballot.html
+[naive]: http://www.codinghorror.com/blog/2007/12/the-danger-of-naivete.html
+
+### Optimizing for speed and space
+
+The solution above isn't as fast, or as lean, as it can be. The list comprehension, when
+transformed into Javascript, is far more complex than it needs to be, and the
+destructured assignment is far slower than dealing with bare variables. The following
+code is less idiomatic, and takes up more source-code space... but will compile down
+smaller and run a bit faster:
+
+{% highlight coffeescript %}
+shuffle = (a) ->
+  i = a.length
+  while --i > 0
+    j = ~~(Math.random() * (i + 1)) # ~~ is a common optimization for Math.floor
+    t = a[j]
+    a[j] = a[i]
+    a[i] = t
+  a
+{% endhighlight %}
+
+### Extending Javascript to include this shuffle.
+
+The following code adds the shuffle function to the Array prototype, which means that
+you are able to run it on any array you wish, in a much more direct manner.
+
+{% highlight coffeescript %}
+Array::shuffle = ->
+  for i in [@length-1..1]
+    j = Math.floor Math.random() * (i + 1)
+    [@[i], @[j]] = [@[j], @[i]]
+  @
+
+[1..9].shuffle()
+# => [ 3, 1, 5, 6, 4, 8, 2, 9, 7 ]
+{% endhighlight %}
+
+**Note:** Although it's quite common in languages like Ruby, extending native objects is 
+often considered bad practice in JavaScript (see: [Maintainable JavaScript: Don’t modify 
+objects you don’t own][dontown]; [Extending built-in native objects. Evil or not?]
+[extendevil]). 
+
+Also, if you think you'll be using a lot of these utility functions, consider using a
+utility library, like [Lo-dash](http://lodash.com/). They include a lot of nifty 
+features, like maps and forEach, in a cross-browser, lean, high-performance way. 
 
-**Note:** Although it's quite common in languages like Ruby, extending native objects is often considered bad practice in JavaScript (see: [Maintainable JavaScript: Don’t modify objects you don’t own](http://www.nczonline.net/blog/2010/03/02/maintainable-javascript-dont-modify-objects-you-down-own/); [Extending built-in native objects. Evil or not?](http://perfectionkills.com/extending-built-in-native-objects-evil-or-not/)).
\ No newline at end of file
+[dontown]: http://www.nczonline.net/blog/2010/03/02/maintainable-javascript-dont-modify-objects-you-down-own/
+[extendevil]: http://perfectionkills.com/extending-built-in-native-objects-evil-or-not/

From 50ab300204df022fedf51ba5117627d01199c31c Mon Sep 17 00:00:00 2001
From: David Brady <dbrady@shinybit.com>
Date: Thu, 28 Feb 2013 15:56:02 -0700
Subject: [PATCH 016/105] Fixed decorator sample (thanks tixz)

* TextDecorator was written in JavaScript-style function assignment,
  making the @processors variable drop out of scope

* Rewrote it as class TextDecorator and included a constructor to set
  the var
---
 chapters/design_patterns/decorator.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/chapters/design_patterns/decorator.md b/chapters/design_patterns/decorator.md
index 0be3d7a..a40ed5c 100644
--- a/chapters/design_patterns/decorator.md
+++ b/chapters/design_patterns/decorator.md
@@ -26,7 +26,9 @@ miniMarkdown = (line) ->
 stripComments = (line) ->
     line.replace /\s*\/\/.*$/, '' # Removes one-line, double-slash C-style comments
 
-TextProcessor = (@processors) ->
+class TextProcessor
+    constructor: (@processors) ->
+
     reducer: (existing, processor) ->
         if processor
             processor(existing or '')

From 0648bcf79c475a0313eed4756cce16575169162c Mon Sep 17 00:00:00 2001
From: d8uv <github@d8uv.org>
Date: Fri, 1 Mar 2013 10:35:26 -0900
Subject: [PATCH 017/105] Make Array::shuffle safer

As mentioned by @dbrady in #72 we shouldn't overwrite a native `Array::shuffle`
---
 chapters/arrays/shuffling-array-elements.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 7963ac4..6e115da 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -79,7 +79,7 @@ The following code adds the shuffle function to the Array prototype, which means
 you are able to run it on any array you wish, in a much more direct manner.
 
 {% highlight coffeescript %}
-Array::shuffle = ->
+do -> Array::shuffle ?= ->
   for i in [@length-1..1]
     j = Math.floor Math.random() * (i + 1)
     [@[i], @[j]] = [@[j], @[i]]
@@ -92,7 +92,9 @@ Array::shuffle = ->
 **Note:** Although it's quite common in languages like Ruby, extending native objects is 
 often considered bad practice in JavaScript (see: [Maintainable JavaScript: Don’t modify 
 objects you don’t own][dontown]; [Extending built-in native objects. Evil or not?]
-[extendevil]). 
+[extendevil]). That being said, the code above is really quite safe to add. It only adds
+`Array::shuffle` if it doesn't exist already, thanks to the existential assignment 
+operator (`?=`). That way, we don't overwrite someone else's, or a native browser method.
 
 Also, if you think you'll be using a lot of these utility functions, consider using a
 utility library, like [Lo-dash](http://lodash.com/). They include a lot of nifty 

From 7eb59ba8fb4b470a3e8f1ac53c33ec1f96842dc4 Mon Sep 17 00:00:00 2001
From: Kevin McDermott <kevin@bigkevmcd.com>
Date: Sat, 2 Mar 2013 21:16:40 -0500
Subject: [PATCH 018/105] Adds initial content for testing with nodeunit

This commit history was rewriten by Devin Weaver <suki@tritarget.org>
---
 chapters/testing/testing_with_nodeunit.md | 172 ++++++++++++++++++++++
 1 file changed, 172 insertions(+)
 create mode 100644 chapters/testing/testing_with_nodeunit.md

diff --git a/chapters/testing/testing_with_nodeunit.md b/chapters/testing/testing_with_nodeunit.md
new file mode 100644
index 0000000..ecdd5e9
--- /dev/null
+++ b/chapters/testing/testing_with_nodeunit.md
@@ -0,0 +1,172 @@
+---
+layout: recipe
+title: Testing with Nodeunit
+chapter: Testing
+---
+## Problem
+
+You are writing a simple calculator using CoffeeScript and you want to verify it functions as expected.  You decide to use the <a href="https://github.com/caolan/nodeunit" target="_blank">Nodeunit</a> test framework.
+
+## Discussion
+
+Nodeunit is a JavaScript implementation of the xUnit family of Unit Testing libraries, similar libraries are available for Java, Python, Ruby, Smalltalk etc.
+
+When using xUnit family test frameworks, you write tests in a file that describes the expected functionality of the code to be tested.
+
+For example, we expect our calculator will be able to add and subtract and will function correctly with both positive and negative numbers.  Our test is listed below.
+
+{% highlight coffeescript %}
+
+# tests/calculator.test.coffee
+
+Calculator = require '../calculator'
+
+exports.CalculatorTest =
+
+    'test can add two positive numbers': (test) ->
+        calculator = new Calculator
+        result = calculator.add 2, 3
+        test.equal(result, 5)
+        test.done()
+
+    'test can handle negative number addition': (test) ->
+        calculator = new Calculator
+        result = calculator.add -10, 5
+        test.equal(result,  -5)
+        test.done()
+
+    'test can subtract two positive numbers': (test) ->
+        calculator = new Calculator
+        result = calculator.subtract 10, 6
+        test.equal(result, 4)
+        test.done()
+
+    'test can handle negative number subtraction': (test) ->
+        calculator = new Calculator
+        result = calculator.subtract 4, -6
+        test.equal(result, 10)
+        test.done()
+
+{% endhighlight %}
+
+### Installing Nodeunit
+
+Before you can run your tests, you must install Nodeunit:
+
+First of allcreate a package.json file
+
+{% highlight javascript %}
+{
+  "name": "calculator",
+  "version": "0.0.1",
+  "scripts": {
+    "test": "./node_modules/.bin/nodeunit test"
+  },
+  "dependencies": {
+    "coffee-script": "~1.4.0",
+    "nodeunit": "~0.7.4"
+  }
+}
+{% endhighlight %}
+
+Next from a terminal run.
+
+{% highlight bash %}
+$ npm install
+{% endhighlight %}
+
+## <span style="color: red;">Running the Tests</span>
+
+It's easy to run the tests from the command-line:
+
+{% highlight bash %}
+$ npm test
+{% endhighlight %}
+
+The test runner should fail, because we have no calculator.coffee
+
+<img src="https://github.com/images/nodeunit_failing_all.png" alt="All failing tests" />
+
+Let's create a simple file 
+
+
+{% highlight coffeescript %}
+
+# calculator.coffee
+
+class Calculator
+
+module.exports = Calculator
+{% endhighlight %}
+
+And re-run the test suite.
+
+<img src="https://github.com/images/nodeunit_failing_better.png" alt="Still failing, but better" />
+
+## <span style="color: green;">Getting the Tests to Pass</span>
+
+Let's implement our methods and see if we can get these tests to pass.
+
+{% highlight coffeescript %}
+
+# calculator.coffee
+
+class Calculator
+
+  add: (a, b) ->
+    a + b
+
+  subtract: (a, b) ->
+    a - b
+
+module.exports = Calculator
+{% endhighlight %}
+
+When we rerun the tests we see they're all passing:
+
+<img src="https://github.com/images/nodeunit_passing.png" alt="All passing" />
+
+
+## <span style="color: green;">Refactoring the Tests</span>
+
+Now that our tests pass, we should look to see if our code or our test(s) can be refactored.
+
+In our test file, each test creates its own calculator instance.  This can make our tests quite repetitive especially for larger test suites.  Ideally, we should consider moving that initialization code into a routine that runs before each test.  
+
+In common with other xUnit libraries, Nodeunit provides a setUp (and tearDown) function which will be called before each test.
+
+{% highlight coffeescript %}
+
+Calculator = require '../calculator'
+
+exports.CalculatorTest =
+
+    setUp: (callback) ->
+        @calculator = new Calculator
+        callback()
+
+    'test can add two positive numbers': (test) ->
+        result = @calculator.add 2, 3
+        test.equal(result, 5)
+        test.done()
+
+    'test can handle negative number addition': (test) ->
+        result = @calculator.add -10, 5
+        test.equal(result,  -5)
+        test.done()
+
+    'test can subtract two positive numbers': (test) ->
+        result = @calculator.subtract 10, 6
+        test.equal(result, 4)
+        test.done()
+
+    'test can handle negative number subtraction': (test) ->
+        result = @calculator.subtract 4, -6
+        test.equal(result, 10)
+        test.done()
+
+{% endhighlight %}
+
+We can rerun the tests and everything should continue to pass.
+
+<img src="https://github.com/images/nodeunit_passing.png" alt="All passing" />

From 5d615dab716fd4879b2a8494a857b2267671b2ec Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Sat, 2 Mar 2013 21:33:43 -0500
Subject: [PATCH 019/105] Converts screen shots to inline code blocks

---
 chapters/testing/testing_with_nodeunit.md | 68 ++++++++++++++++++++---
 1 file changed, 61 insertions(+), 7 deletions(-)

diff --git a/chapters/testing/testing_with_nodeunit.md b/chapters/testing/testing_with_nodeunit.md
index ecdd5e9..30af5b8 100644
--- a/chapters/testing/testing_with_nodeunit.md
+++ b/chapters/testing/testing_with_nodeunit.md
@@ -53,7 +53,7 @@ exports.CalculatorTest =
 
 Before you can run your tests, you must install Nodeunit:
 
-First of allcreate a package.json file
+First of all create a `package.json` file
 
 {% highlight javascript %}
 {
@@ -85,10 +85,21 @@ $ npm test
 
 The test runner should fail, because we have no calculator.coffee
 
-<img src="https://github.com/images/nodeunit_failing_all.png" alt="All failing tests" />
+    suki@Yuzuki:nodeunit_testing (master)$ npm test
+    npm WARN package.json calculator@0.0.1 No README.md file found!
 
-Let's create a simple file 
+    > calculator@0.0.1 test /Users/suki/tmp/nodeunit_testing
+    > ./node_modules/.bin/nodeunit test
+
+
+    /Users/suki/tmp/nodeunit_testing/node_modules/nodeunit/lib/nodeunit.js:72
+            if (err) throw err;
+                           ^
+    Error: ENOENT, stat '/Users/suki/tmp/nodeunit_testing/test'
+    npm ERR! Test failed.  See above for more details.
+    npm ERR! not ok code 0
 
+Let's create a simple file 
 
 {% highlight coffeescript %}
 
@@ -101,7 +112,39 @@ module.exports = Calculator
 
 And re-run the test suite.
 
-<img src="https://github.com/images/nodeunit_failing_better.png" alt="Still failing, but better" />
+    suki@Yuzuki:nodeunit_testing (master)$ npm test
+    npm WARN package.json calculator@0.0.1 No README.md file found!
+
+    > calculator@0.0.1 test /Users/suki/tmp/nodeunit_testing
+    > ./node_modules/.bin/nodeunit test
+
+
+    calculator.test
+    ✖ CalculatorTest - test can add two positive numbers
+
+    TypeError: Object #<Calculator> has no method 'add'
+      ...
+
+    ✖ CalculatorTest - test can handle negative number addition
+
+    TypeError: Object #<Calculator> has no method 'add'
+      ...
+
+    ✖ CalculatorTest - test can subtract two positive numbers
+
+    TypeError: Object #<Calculator> has no method 'subtract'
+      ...
+
+    ✖ CalculatorTest - test can handle negative number subtraction
+
+    TypeError: Object #<Calculator> has no method 'subtract'
+      ...
+
+
+    FAILURES: 4/4 assertions failed (31ms)
+    npm ERR! Test failed.  See above for more details.
+    npm ERR! not ok code 0
+
 
 ## <span style="color: green;">Getting the Tests to Pass</span>
 
@@ -124,7 +167,20 @@ module.exports = Calculator
 
 When we rerun the tests we see they're all passing:
 
-<img src="https://github.com/images/nodeunit_passing.png" alt="All passing" />
+    suki@Yuzuki:nodeunit_testing (master)$ npm test
+    npm WARN package.json calculator@0.0.1 No README.md file found!
+
+    > calculator@0.0.1 test /Users/suki/tmp/nodeunit_testing
+    > ./node_modules/.bin/nodeunit test
+
+
+    calculator.test
+    ✔ CalculatorTest - test can add two positive numbers
+    ✔ CalculatorTest - test can handle negative number addition
+    ✔ CalculatorTest - test can subtract two positive numbers
+    ✔ CalculatorTest - test can handle negative number subtraction
+
+    OK: 4 assertions (27ms)
 
 
 ## <span style="color: green;">Refactoring the Tests</span>
@@ -168,5 +224,3 @@ exports.CalculatorTest =
 {% endhighlight %}
 
 We can rerun the tests and everything should continue to pass.
-
-<img src="https://github.com/images/nodeunit_passing.png" alt="All passing" />

From d082571bd6776c2d65fd03aa2ad15c89d4c0b727 Mon Sep 17 00:00:00 2001
From: d8uv <github@d8uv.org>
Date: Mon, 11 Mar 2013 13:51:26 -0700
Subject: [PATCH 020/105] Detecting and Creating Missing Functions rewrite
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

New solution, and greatly expanded discussion section
to explain it.

From:
  unless Class::member
    Class::member = contents

To:
  do -> Class::member ?= contents
---
 .../detecting-and-replacing-functions.md          | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/chapters/metaprogramming/detecting-and-replacing-functions.md b/chapters/metaprogramming/detecting-and-replacing-functions.md
index 6a99931..f8d81b5 100644
--- a/chapters/metaprogramming/detecting-and-replacing-functions.md
+++ b/chapters/metaprogramming/detecting-and-replacing-functions.md
@@ -9,12 +9,11 @@ You want to detect if a function exists and create it if it does not (such as an
 
 ## Solution
 
-Use `::` to detect the function, and assign to it if it does not exist.
+Use the existential assignment operator (`?=`) to assign a function to the classes' prototype (using the `::` shorthand), and wrap it all in a IIFE (`do ->`) to contain the variables.
 
 {% highlight coffeescript %}
-unless Array::filter
-  Array::filter = (callback) ->
-    element for element in this when callback element
+do -> Array::filter ?= (callback) ->
+  element for element in this when callback element
 
 array = [1..10]
 
@@ -24,4 +23,10 @@ array.filter (x) -> x > 5
 
 ## Discussion
 
-Objects in JavaScript (and thus, in CoffeeScript) have a prototype member that defines what member functions should be available on all objects based on that prototype. In CoffeeScript, you can access the prototype directly via the `::` operator.
+Objects in JavaScript (and thus, in CoffeeScript) have a prototype member that defines what member functions should be available on all objects based on that prototype.  
+In Coffeescript, you access this prototype using the `::` shortcut. So, if you want to add a filter function to the array class, you do `Array::filter = ...`. This will add the filter function to all arrays.
+
+However, we don't ever want to overwrite a prototype that we haven't created in the first place. For example, if `Array::filter` already exists in a fast native form in the browser, or a library maker has their own specific version of `Array::filter`, then you'll either replace the quick native version with a slow Javascript version, or you will break the library that depends on their own Array::shuffle.  
+What you need to do is only add the function if it doesn't already exist. That's where the existential assignment operator (`?=`) comes in. If we do `Array::filter ?= ...` instead, it will see if `Array::filter` already exists. If it does, then it will use the current version. If it doesn't, it will add yours.
+
+Finally, because the existential assignment operator--when compiled--creates a few variables, we clean up the code by wrapping it in an [Immediately-Invoked Function Expression (IIFE)](http://benalman.com/news/2010/11/immediately-invoked-function-expression/). This hides those internal-use-only variables from leaking outside. So, if the function we're writing already exists, it runs, does basically nothing, and exits, affecting absolutely none of your code. But, if the function we're writing *doesn't* exist, we send out only the function we're writing as a closure, so only the function you've made affects the code. The internal workings of `?=` are hidden either way.

From e9076fec3027a267eb585c6ff94e414d445ff29e Mon Sep 17 00:00:00 2001
From: d8uv <github@d8uv.org>
Date: Mon, 11 Mar 2013 18:11:19 -0700
Subject: [PATCH 021/105] Add annotated javascript of Polyfill pattern rewrite

---
 .../detecting-and-replacing-functions.md      | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/chapters/metaprogramming/detecting-and-replacing-functions.md b/chapters/metaprogramming/detecting-and-replacing-functions.md
index f8d81b5..4ba7b64 100644
--- a/chapters/metaprogramming/detecting-and-replacing-functions.md
+++ b/chapters/metaprogramming/detecting-and-replacing-functions.md
@@ -30,3 +30,33 @@ However, we don't ever want to overwrite a prototype that we haven't created in
 What you need to do is only add the function if it doesn't already exist. That's where the existential assignment operator (`?=`) comes in. If we do `Array::filter ?= ...` instead, it will see if `Array::filter` already exists. If it does, then it will use the current version. If it doesn't, it will add yours.
 
 Finally, because the existential assignment operator--when compiled--creates a few variables, we clean up the code by wrapping it in an [Immediately-Invoked Function Expression (IIFE)](http://benalman.com/news/2010/11/immediately-invoked-function-expression/). This hides those internal-use-only variables from leaking outside. So, if the function we're writing already exists, it runs, does basically nothing, and exits, affecting absolutely none of your code. But, if the function we're writing *doesn't* exist, we send out only the function we're writing as a closure, so only the function you've made affects the code. The internal workings of `?=` are hidden either way.
+
+### Example
+
+Below, we've compiled and annotated the coffeescript written in the solution above
+
+{% highlight javascript %}
+// (function(){ ... })() is an IIFE, compiled in thanks to `do ->`
+(function() {
+
+  // This is from the `?=` operator, used to check if Array.prototype.filter (`Array::filter`) exists.
+  // If it does, we set it to itself, and return. If it doesn't, then we set it to the function, and return the function.
+  // The IIFE is only used to hide _base and _ref from the outside world.
+  var _base, _ref;
+  return (_ref = (_base = Array.prototype).filter) != null ? _ref : _base.filter = function(callback) {
+
+    // `element for element in this when callback element`
+    var element, _i, _len, _results;
+    _results = [];
+    for (_i = 0, _len = this.length; _i < _len; _i++) {
+      element = this[_i];
+      if (callback(element)) {
+        _results.push(element);
+      }
+    }
+    return _results;
+    
+  };
+// The end of the IIFE from `do ->`
+})();
+{% endhighlight %}

From 0836946e99dc65051fc9a91bf568dcc612dc5dd5 Mon Sep 17 00:00:00 2001
From: Kris Budde <Kris.Budde@gmail.com>
Date: Mon, 18 Mar 2013 22:30:52 +0100
Subject: [PATCH 022/105] Chaining recipe changed. Property array was shared
 between instances

---
 chapters/classes_and_objects/chaining.md | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/chapters/classes_and_objects/chaining.md b/chapters/classes_and_objects/chaining.md
index bec3a46..65f450f 100644
--- a/chapters/classes_and_objects/chaining.md
+++ b/chapters/classes_and_objects/chaining.md
@@ -13,10 +13,11 @@ Return the `this` (i.e. `@`) object after every chained method.
 
 {% highlight coffeescript %}
 class CoffeeCup
-	properties:
-		strength: 'medium'
-		cream: false
-		sugar: false
+	constructor:  ->
+		@properties=
+			strength: 'medium'
+			cream: false
+			sugar: false
 	strength: (newStrength) ->
 		@properties.strength = newStrength
 		@
@@ -57,13 +58,13 @@ addChainedAttributeAccessor = (obj, propertyAttr, attr) ->
 			obj
 
 class TeaCup
-	properties:
-		size: 'medium'
-		type: 'black'
-		sugar: false
-		cream: false
-
-addChainedAttributeAccessor(TeaCup.prototype, 'properties', attr) for attr of TeaCup.prototype.properties
+	constructor:  ->
+		@properties=
+			size: 'medium'
+			type: 'black'
+			sugar: false
+			cream: false
+		addChainedAttributeAccessor(this, 'properties', attr) for attr of @properties
 
 earlgrey = new TeaCup().size('small').type('Earl Grey').sugar('false')
 

From 57c445a9d4f23b1b744c3dd06d3e7f1a85311441 Mon Sep 17 00:00:00 2001
From: Iain Beeston <iain.beeston@gmail.com>
Date: Tue, 9 Apr 2013 15:20:30 +1000
Subject: [PATCH 023/105] Showed how to access from an instance method

---
 chapters/classes_and_objects/class-variables.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/chapters/classes_and_objects/class-variables.md b/chapters/classes_and_objects/class-variables.md
index d48ed9c..b7025bd 100644
--- a/chapters/classes_and_objects/class-variables.md
+++ b/chapters/classes_and_objects/class-variables.md
@@ -13,6 +13,9 @@ You want to create a class variable.
 class Zoo
   @MAX_ANIMALS: 50
   MAX_ZOOKEEPERS: 3
+  
+  helpfulInfo: =>
+    "Zoos may contain a maximum of #{@constructor.MAX_ANIMALS} animals"
 
 Zoo.MAX_ANIMALS
 # => 50
@@ -23,6 +26,8 @@ Zoo.MAX_ZOOKEEPERS
 zoo = new Zoo
 zoo.MAX_ZOOKEEPERS
 # => 3
+zoo.helpfulInfo()
+# => "Zoos may contain a maximum of 50 animals"
 {% endhighlight %}
 
 ## Discussion

From fab61fb07fd55c37f62da1973f38818242ccc002 Mon Sep 17 00:00:00 2001
From: Jameson Quinn <jameson.quinn@gmail.com>
Date: Thu, 25 Apr 2013 14:53:15 -0600
Subject: [PATCH 024/105] Mixins recipe

---
 chapters/classes_and_objects/mixins.md | 49 ++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 chapters/classes_and_objects/mixins.md

diff --git a/chapters/classes_and_objects/mixins.md b/chapters/classes_and_objects/mixins.md
new file mode 100644
index 0000000..8f99d84
--- /dev/null
+++ b/chapters/classes_and_objects/mixins.md
@@ -0,0 +1,49 @@
+---
+layout: recipe
+title: Mixins for classes
+chapter: Classes and Objects
+---
+## Problem
+
+You have a few utility methods that you want to include in a number of different classes.
+
+## Solution
+
+Use a mixOf factory function that generates a mixed superclass for you.
+
+{% highlight coffeescript %}
+mixOf = (base, mixins...) ->
+  class Mixed extends base
+  for mixin in mixins by -1 #earlier mixins override later ones
+    for name, method of mixin::
+      Mixed::[name] = method
+  Mixed
+
+...
+
+class DeepThought
+  answer: ->
+    42
+    
+class PhilosopherMixin
+  pontificate: ->
+    console.log "hmm..."
+    @wise = yes
+
+class DeeperThought extends mixOf DeepThought, PhilosopherMixin
+  answer: ->
+    @pontificate()
+    super()
+    
+earth = new DeeperThought
+earth.answer()
+# hmm...
+# => 42
+{% endhighlight %}
+
+## Discussion
+
+This is intended for lightweight mixins. Thus you inherit methods of the
+base and its ancestors, and those of the mixins, but not those of the ancestors of 
+the mixins. Also, after declaring a mixed class, further changes in the mixins are not 
+reflected.

From b16a9071dd6833cf2689e6380b7fc417c99a4f0b Mon Sep 17 00:00:00 2001
From: guillaumebiton <guillaume.biton@free.fr>
Date: Thu, 30 May 2013 12:13:47 +0200
Subject: [PATCH 025/105] new template for arrays of objects (collections?)

---
 .../arrays/where-for-arrays-of-objects.md     | 76 +++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 chapters/arrays/where-for-arrays-of-objects.md

diff --git a/chapters/arrays/where-for-arrays-of-objects.md b/chapters/arrays/where-for-arrays-of-objects.md
new file mode 100644
index 0000000..1c6d4d7
--- /dev/null
+++ b/chapters/arrays/where-for-arrays-of-objects.md
@@ -0,0 +1,76 @@
+---
+layout: recipe
+title: where for arrays of objects
+chapter: Arrays
+---
+## Problem
+
+You want to get an array of objects that match your request for some properties
+
+You have an Array of Objects, such as:
+
+{% highlight coffeescript %}
+cats = [
+  {
+    name: "Bubbles"
+    favoriteFood: "mice"
+    age: 1
+  },
+  {
+    name: "Sparkle"
+    favoriteFood: "tuna"
+  },
+  {
+    name: "flyingCat"
+    favoriteFood: "mice"
+    age: 1
+  }
+]
+{% endhighlight %}
+
+You want to filter with some properties, like cats.where({ age: 1}) or cats.where({ age: 1, favoriteFood: "mice"})
+
+## Solution
+
+You can extend Array like this : 
+
+{% highlight coffeescript %}
+Array::where = (query) ->
+    return [] if typeof query isnt "object"
+    hit = Object.keys(query).length
+    @filter (item) ->
+        match = 0
+        for key, val of query
+            match += 1 if item[key] is val
+        if match is hit then true else false
+
+cats.where age:1
+# => [ { name: 'Bubbles', favoriteFood: 'mice', age: 1 },{ name: 'flyingCat', favoriteFood: 'mice', age: 1 } ]
+
+cats.where age:1, name: "Bubbles"
+# => [ { name: 'Bubbles', favoriteFood: 'mice', age: 1 } ]
+
+cats.where age:1, favoriteFood:"tuna"
+# => []
+{% endhighlight %}
+
+## Discussion
+
+This is an exact match. we could make it more flexible with a matcher function :
+
+{% highlight coffeescript %}
+Array::where = (query, matcher = (a,b) -> a is b) ->
+    return [] if typeof query isnt "object"
+    hit = Object.keys(query).length
+    @filter (item) ->
+        match = 0
+        for key, val of query
+            match += 1 if matcher(item[key], val)
+        if match is hit then true else false
+
+cats.where name:"bubbles", (a, b) -> "#{ a }".toLowerCase() is "#{ b }".toLowerCase()
+# => [ { name: 'Bubbles', favoriteFood: 'mice', age: 1 } ]
+# now it's case insensitive
+{% endhighlight %}
+
+it's more a method to deal with collection and it could be rename as "find" but popular libraires like underscore or lodash name it "where". 

From 0b3e4cdbdbfa0a10cdc04516aa405a6a1730b9b2 Mon Sep 17 00:00:00 2001
From: guillaumebiton <guillaume.biton@free.fr>
Date: Thu, 30 May 2013 12:20:05 +0200
Subject: [PATCH 026/105] update discussion example

---
 chapters/arrays/where-for-arrays-of-objects.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/chapters/arrays/where-for-arrays-of-objects.md b/chapters/arrays/where-for-arrays-of-objects.md
index 1c6d4d7..51eba6d 100644
--- a/chapters/arrays/where-for-arrays-of-objects.md
+++ b/chapters/arrays/where-for-arrays-of-objects.md
@@ -68,6 +68,10 @@ Array::where = (query, matcher = (a,b) -> a is b) ->
             match += 1 if matcher(item[key], val)
         if match is hit then true else false
 
+cats.where name:"bubbles"
+# => []
+# it's case sensitive
+
 cats.where name:"bubbles", (a, b) -> "#{ a }".toLowerCase() is "#{ b }".toLowerCase()
 # => [ { name: 'Bubbles', favoriteFood: 'mice', age: 1 } ]
 # now it's case insensitive

From 2be90d11d14e1f86e8ce769b3f1efa11c0b414a3 Mon Sep 17 00:00:00 2001
From: Michael Glass <me@mike.is>
Date: Tue, 18 Jun 2013 12:05:55 -0700
Subject: [PATCH 027/105] lesson on class variables is incorrect. putting
 attributes on the prototype does not use more memory than putting it on the
 constructor function.

---
 chapters/classes_and_objects/class-variables.md | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/chapters/classes_and_objects/class-variables.md b/chapters/classes_and_objects/class-variables.md
index b7025bd..dd8713f 100644
--- a/chapters/classes_and_objects/class-variables.md
+++ b/chapters/classes_and_objects/class-variables.md
@@ -15,21 +15,29 @@ class Zoo
   MAX_ZOOKEEPERS: 3
   
   helpfulInfo: =>
-    "Zoos may contain a maximum of #{@constructor.MAX_ANIMALS} animals"
+    "Zoos may contain a maximum of #{@constructor.MAX_ANIMALS} animals and #{@MAX_ZOOKEEPERS} zoo keepers."
 
 Zoo.MAX_ANIMALS
 # => 50
 
 Zoo.MAX_ZOOKEEPERS
-# => undefined (it is an instance variable)
+# => undefined (it is a prototype member)
+
+Zoo::MAX_ZOOKEEPERS
+# => 3
 
 zoo = new Zoo
 zoo.MAX_ZOOKEEPERS
 # => 3
 zoo.helpfulInfo()
-# => "Zoos may contain a maximum of 50 animals"
+# => "Zoos may contain a maximum of 50 animals and 3 zoo keepers."
+
+zoo.MAX_ZOOKEEPERS = "smelly"
+zoo.MAX_ANIMALS = "seventeen"
+zoo.helpfulInfo()
+# => "Zoos may contain a maximum of 50 animals and smelly zoo keepers."
 {% endhighlight %}
 
 ## Discussion
 
-Coffeescript will store these values on the object itself rather than on the object prototype (and thus on individual object instances), which conserves memory and gives a central location to store class-level values.
+Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overrided by instance attribute variables.

From cb75e69b835b1a4bd6ce1295cf0003f42f9d0e2d Mon Sep 17 00:00:00 2001
From: tashemi <shemyakina.tatiana@gmail.com>
Date: Sat, 27 Jul 2013 01:37:49 +0300
Subject: [PATCH 028/105] Create observer.md

---
 chapters/design_patterns/observer.md | 44 ++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 chapters/design_patterns/observer.md

diff --git a/chapters/design_patterns/observer.md b/chapters/design_patterns/observer.md
new file mode 100644
index 0000000..1fe5ab2
--- /dev/null
+++ b/chapters/design_patterns/observer.md
@@ -0,0 +1,44 @@
+---
+layout: recipe Observer Pattern
+title: Observer Pattern
+chapter: Design patterns
+---
+## Problem
+
+You have to notify some objects about an event happen
+
+## Solution
+
+Use an [Observer Pattern](http://en.wikipedia.org/wiki/Observer_pattern)
+
+{% highlight coffeescript %}
+class PostOffice
+  constructor: () ->
+    @subscribers = []
+  sendNewItemReleased: (item) ->
+    subscriber.callback(item) for subscriber in @subscribers when subscriber.item is item
+    return
+  subscribe: (to, onNewItemReleased) ->
+    @subscribers.push({'item':to, 'callback':onNewItemReleased})
+class MagazineSubscriber
+  onNewMagazine: (item) ->
+    alert "I've got new "+item
+class NewspaperSubscriber
+  onNewNewspaper: (item) ->
+    alert "I've got new "+item
+
+postOffice = new PostOffice()
+sub1 = new MagazineSubscriber()
+sub2 = new NewspaperSubscriber()
+postOffice.subscribe "Mens Health", sub1.onNewMagazine
+postOffice.subscribe "Times", sub2.onNewNewspaper
+postOffice.sendNewItemReleased "Times"
+postOffice.sendNewItemReleased "Mens Health"
+{% endhighlight %}
+
+## Discussion
+
+Here you have an observer object (PostOffice) and observable objects (MagazineSubscriber, NewspaperSubscriber). 
+To be notified about an event of publishing new periodical observable object should make subscribtion on PostOffice. 
+Every of subscribed objects is stored internaly in the PostOffice array of subscribers. 
+Every subscriber is notified on new concrete periodical is published.

From 28e5392493057dc64b5087bf6eb0671cc30b4fb4 Mon Sep 17 00:00:00 2001
From: tashemi <shemyakina.tatiana@gmail.com>
Date: Sat, 27 Jul 2013 01:51:26 +0300
Subject: [PATCH 029/105] Update code

---
 chapters/design_patterns/observer.md | 31 +++++++++++++++-------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/chapters/design_patterns/observer.md b/chapters/design_patterns/observer.md
index 1fe5ab2..4976e63 100644
--- a/chapters/design_patterns/observer.md
+++ b/chapters/design_patterns/observer.md
@@ -12,33 +12,36 @@ You have to notify some objects about an event happen
 Use an [Observer Pattern](http://en.wikipedia.org/wiki/Observer_pattern)
 
 {% highlight coffeescript %}
+
 class PostOffice
-  constructor: () ->
-    @subscribers = []
-  sendNewItemReleased: (item) ->
-    subscriber.callback(item) for subscriber in @subscribers when subscriber.item is item
-    return
-  subscribe: (to, onNewItemReleased) ->
-    @subscribers.push({'item':to, 'callback':onNewItemReleased})
+	constructor: () ->
+		@subscribers = []
+	notifyNewItemReleased: (item) ->
+		subscriber.callback(item) for subscriber in @subscribers when subscriber.item is item
+	subscribe: (to, onNewItemReleased) ->
+		@subscribers.push {'item':to, 'callback':onNewItemReleased}
+    
 class MagazineSubscriber
-  onNewMagazine: (item) ->
-    alert "I've got new "+item
+	onNewMagazine: (item) ->
+		alert "I've got new "+item
+
 class NewspaperSubscriber
-  onNewNewspaper: (item) ->
-    alert "I've got new "+item
+	onNewNewspaper: (item) ->
+		alert "I've got new "+item
 
 postOffice = new PostOffice()
 sub1 = new MagazineSubscriber()
 sub2 = new NewspaperSubscriber()
 postOffice.subscribe "Mens Health", sub1.onNewMagazine
 postOffice.subscribe "Times", sub2.onNewNewspaper
-postOffice.sendNewItemReleased "Times"
-postOffice.sendNewItemReleased "Mens Health"
+postOffice.notifyNewItemReleased "Times"
+postOffice.notifyNewItemReleased "Mens Health"
+
 {% endhighlight %}
 
 ## Discussion
 
 Here you have an observer object (PostOffice) and observable objects (MagazineSubscriber, NewspaperSubscriber). 
 To be notified about an event of publishing new periodical observable object should make subscribtion on PostOffice. 
-Every of subscribed objects is stored internaly in the PostOffice array of subscribers. 
+Every of subscribed objects is stored internaly in the PostOffice array of subscribtions. 
 Every subscriber is notified on new concrete periodical is published.

From 46a0b9e3c2c159b18125aea2cde15a67a52f3ac7 Mon Sep 17 00:00:00 2001
From: Pedro Medeiros <pedrosnk@gmail.com>
Date: Sat, 27 Jul 2013 22:12:15 -0300
Subject: [PATCH 030/105] fix observer page layout and remove :rubygems that is
 deprecated from Gemfile

---
 Gemfile                              |  2 +-
 chapters/design_patterns/observer.md | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Gemfile b/Gemfile
index b744ba1..ebe0f96 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,4 +1,4 @@
-source :rubygems
+source 'http://rubygems.org/'
 
 group :development do
   gem "RedCloth", "~> 4.2"
diff --git a/chapters/design_patterns/observer.md b/chapters/design_patterns/observer.md
index 4976e63..f796b78 100644
--- a/chapters/design_patterns/observer.md
+++ b/chapters/design_patterns/observer.md
@@ -1,5 +1,5 @@
 ---
-layout: recipe Observer Pattern
+layout: recipe
 title: Observer Pattern
 chapter: Design patterns
 ---
@@ -20,7 +20,7 @@ class PostOffice
 		subscriber.callback(item) for subscriber in @subscribers when subscriber.item is item
 	subscribe: (to, onNewItemReleased) ->
 		@subscribers.push {'item':to, 'callback':onNewItemReleased}
-    
+
 class MagazineSubscriber
 	onNewMagazine: (item) ->
 		alert "I've got new "+item
@@ -41,7 +41,7 @@ postOffice.notifyNewItemReleased "Mens Health"
 
 ## Discussion
 
-Here you have an observer object (PostOffice) and observable objects (MagazineSubscriber, NewspaperSubscriber). 
-To be notified about an event of publishing new periodical observable object should make subscribtion on PostOffice. 
-Every of subscribed objects is stored internaly in the PostOffice array of subscribtions. 
+Here you have an observer object (PostOffice) and observable objects (MagazineSubscriber, NewspaperSubscriber).
+To be notified about an event of publishing new periodical observable object should make subscribtion on PostOffice.
+Every of subscribed objects is stored internaly in the PostOffice array of subscribtions.
 Every subscriber is notified on new concrete periodical is published.

From 57747556034440204359f767646b458ca4bb0ed9 Mon Sep 17 00:00:00 2001
From: Tatiana Shemiakina <shemyakina.tatiana@gmail.com>
Date: Tue, 30 Jul 2013 22:23:19 +0300
Subject: [PATCH 031/105] Create adapter

---
 chapters/design_patterns/adapter | 60 ++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 chapters/design_patterns/adapter

diff --git a/chapters/design_patterns/adapter b/chapters/design_patterns/adapter
new file mode 100644
index 0000000..95db31a
--- /dev/null
+++ b/chapters/design_patterns/adapter
@@ -0,0 +1,60 @@
+---
+layout: default
+title: Adapter pattern
+---
+
+## Sample recipe template
+
+Create a new `my-recipe.md` file and use this text as a start.
+
+{% highlight text %}
+---
+layout: recipe
+title: Adapter patter
+chapter: Design patterns
+---
+## Problem
+
+Suppose we have 3-rd party grid component. We want to apply there our own custom sorting but a small problem. Our custom sorter does not implement required interface by grid component.
+To understand the problem completely best example would be an socket from our usual life. Everybody knows this device. In some countries it has 3 pins and in other contries it has only 2 pins. 
+This is exactly right situation to use adapter. 
+
+## Solution
+
+#grid component
+class AwesomeGrid
+	constructor: (@datasource)->
+		@sort_order = 'ASC' 
+		@sorter = new NullSorter # in this place we use NullObject pattern (another usefull pattern)
+	setCustomSorter: (@customSorter) ->
+		@sorter = customSorter
+	sort: () ->
+		@datasource = @sorter.sort @datasource, @sort_order
+		# don't forget to change sort order
+
+
+class NullSorter
+	sort: (data, order) -> # do nothing; it is just a stub
+	
+class RandomSorter
+	sort: (data)->
+		for i in [data.length-1..1] #let's shuffle the data a bit
+    			j = Math.floor Math.random() * (i + 1)
+    			[data[i], data[j]] = [data[j], data[i]]
+		return data
+
+class RandomSorterAdapter
+	constructor: (@sorter) ->
+	sort: (data, order) ->
+		@sorter.sort data
+
+agrid = new AwesomeGrid ['a','b','c','d','e','f']
+agrid.setCustomSorter new RandomSorterAdapter(new RandomSorter)
+agrid.sort() # sort data with custom sorter through adapter
+
+## Discussion
+
+Adapter is usefull when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 
+In any case be carefull with adapter: it can be helpfull but it can instigate design errors. 
+
+{% endhighlight %}

From 8a510977fd926dcf3e0ada13545b6990b514a1a5 Mon Sep 17 00:00:00 2001
From: Tatiana Shemiakina <shemyakina.tatiana@gmail.com>
Date: Tue, 30 Jul 2013 22:26:02 +0300
Subject: [PATCH 032/105] Update and rename adapter to adapter.md

---
 chapters/design_patterns/{adapter => adapter.md} | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
 rename chapters/design_patterns/{adapter => adapter.md} (95%)

diff --git a/chapters/design_patterns/adapter b/chapters/design_patterns/adapter.md
similarity index 95%
rename from chapters/design_patterns/adapter
rename to chapters/design_patterns/adapter.md
index 95db31a..e6a3d67 100644
--- a/chapters/design_patterns/adapter
+++ b/chapters/design_patterns/adapter.md
@@ -20,8 +20,8 @@ To understand the problem completely best example would be an socket from our us
 This is exactly right situation to use adapter. 
 
 ## Solution
-
-#grid component
+{% highlight coffeescript %}
+# a fragment of 3-rd party grid component
 class AwesomeGrid
 	constructor: (@datasource)->
 		@sort_order = 'ASC' 
@@ -52,6 +52,8 @@ agrid = new AwesomeGrid ['a','b','c','d','e','f']
 agrid.setCustomSorter new RandomSorterAdapter(new RandomSorter)
 agrid.sort() # sort data with custom sorter through adapter
 
+{% endhighlight %}
+
 ## Discussion
 
 Adapter is usefull when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 

From 5fc588889f546f4f958f782c6c4b268712dacd6f Mon Sep 17 00:00:00 2001
From: Tatiana Shemiakina <shemyakina.tatiana@gmail.com>
Date: Tue, 30 Jul 2013 22:33:03 +0300
Subject: [PATCH 033/105] Update markup; add link to wiki adapter page

---
 chapters/design_patterns/adapter.md | 15 ++-------------
 1 file changed, 2 insertions(+), 13 deletions(-)

diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index e6a3d67..8be4ece 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -1,14 +1,4 @@
 ---
-layout: default
-title: Adapter pattern
----
-
-## Sample recipe template
-
-Create a new `my-recipe.md` file and use this text as a start.
-
-{% highlight text %}
----
 layout: recipe
 title: Adapter patter
 chapter: Design patterns
@@ -17,9 +7,10 @@ chapter: Design patterns
 
 Suppose we have 3-rd party grid component. We want to apply there our own custom sorting but a small problem. Our custom sorter does not implement required interface by grid component.
 To understand the problem completely best example would be an socket from our usual life. Everybody knows this device. In some countries it has 3 pins and in other contries it has only 2 pins. 
-This is exactly right situation to use adapter. 
+This is exactly right situation to use [adapter pattern](https://en.wikipedia.org/wiki/Adapter_pattern). 
 
 ## Solution
+
 {% highlight coffeescript %}
 # a fragment of 3-rd party grid component
 class AwesomeGrid
@@ -58,5 +49,3 @@ agrid.sort() # sort data with custom sorter through adapter
 
 Adapter is usefull when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 
 In any case be carefull with adapter: it can be helpfull but it can instigate design errors. 
-
-{% endhighlight %}

From a97b9d157f8bb95c14bb45fca2ed151b27334916 Mon Sep 17 00:00:00 2001
From: erik <erik@xenophanes.(none)>
Date: Tue, 6 Aug 2013 11:51:51 -0500
Subject: [PATCH 034/105] Simplified and sped up the "type-function" example.

---
 chapters/classes_and_objects/type-function.md | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/chapters/classes_and_objects/type-function.md b/chapters/classes_and_objects/type-function.md
index 42952ac..96e8cea 100644
--- a/chapters/classes_and_objects/type-function.md
+++ b/chapters/classes_and_objects/type-function.md
@@ -12,16 +12,20 @@ You'd like to know the type of a object without using typeof. (See http://javasc
 Use the following function:
 
 {% highlight coffeescript %}
-type = (obj) ->
-  if obj == undefined or obj == null
-    return String obj
-  classToType = new Object
-  for name in "Boolean Number String Function Array Date RegExp".split(" ")
-    classToType["[object " + name + "]"] = name.toLowerCase()
-  myClass = Object.prototype.toString.call obj
-  if myClass of classToType
-    return classToType[myClass]
-  return "object"
+  type = (obj) ->
+    if obj == undefined or obj == null
+      return String obj
+    classToType = {
+      '[object Boolean]': 'boolean',
+      '[object Number]': 'number',
+      '[object String]': 'string',
+      '[object Function]': 'function',
+      '[object Array]': 'array',
+      '[object Date]': 'date',
+      '[object RegExp]': 'regexp',
+      '[object Object]': 'object'
+    }
+    return classToType[Object.prototype.toString.call(obj)]
 {% endhighlight %}
 
 ## Discussion

From 8bd340fb0c863c116e4cf248c7c0d733d6e662fb Mon Sep 17 00:00:00 2001
From: Frankie Bagnardi <f.bagnardi@gmail.com>
Date: Sat, 10 Aug 2013 03:01:08 -0700
Subject: [PATCH 035/105] Math.max.apply note is confusing

---
 chapters/arrays/max-array-value.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/chapters/arrays/max-array-value.md b/chapters/arrays/max-array-value.md
index 906eaac..ce3adc1 100644
--- a/chapters/arrays/max-array-value.md
+++ b/chapters/arrays/max-array-value.md
@@ -16,18 +16,14 @@ Math.max [12, 32, 11, 67, 1, 3]...
 # => 67
 {% endhighlight %}
 
-Alternatively, it's possible to use ES5 `reduce` method. For backward compatibility with older JavaScript implementations, use Math.max.apply:
+Alternatively, it's possible to use ES5 `reduce` method. For backward compatibility with older JavaScript implementations, use the above.
 
 {% highlight coffeescript %}
 # ECMAScript 5
 [12,32,11,67,1,3].reduce (a,b) -> Math.max a, b
 # => 67
-
-# Pre-ES5
-Math.max.apply(null, [12,32,11,67,1,3])
-# => 67
 {% endhighlight %}
 
 ## Discussion
 
-`Math.max` compares every argument and returns the largest number from arguments. The ellipsis (`...`) converts every array value into argument which is given to the function. You can also use it with other functions which take variable ammount of arguments, such as `console.log`.
\ No newline at end of file
+`Math.max` compares every argument and returns the largest number from arguments. The ellipsis (`...`) converts every array value into argument which is given to the function. You can also use it with other functions which take variable ammount of arguments, such as `console.log`.

From 3d3acde05f6d749adcdf87e85617dd689e96d29c Mon Sep 17 00:00:00 2001
From: Frankie Bagnardi <f.bagnardi@gmail.com>
Date: Sat, 10 Aug 2013 03:19:18 -0700
Subject: [PATCH 036/105] r.randi is undefined, should be r.rand

---
 chapters/math/generating-predictable-random-numbers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/math/generating-predictable-random-numbers.md b/chapters/math/generating-predictable-random-numbers.md
index a7cc561..128bc61 100644
--- a/chapters/math/generating-predictable-random-numbers.md
+++ b/chapters/math/generating-predictable-random-numbers.md
@@ -62,4 +62,4 @@ Avoid the temptation to modulus the output of this generator. If you need an int
 r.randn() % 2
 {% endhighlight %}
 
-because you will most definitely not get random digits. Use `r.randi(2)` instead.
+because you will most definitely not get random digits. Use `r.rand(2)` instead.

From c2ff4ae0fa8123dfdefe3f2653fea3c92cc82e5a Mon Sep 17 00:00:00 2001
From: Peter Hellberg <peter@c7.se>
Date: Sun, 18 Aug 2013 14:19:13 +0200
Subject: [PATCH 037/105] Updated development dependencies

---
 Gemfile      | 12 +++----
 Gemfile.lock | 98 ++++++++++++++++++++++++++++++++++------------------
 2 files changed, 70 insertions(+), 40 deletions(-)

diff --git a/Gemfile b/Gemfile
index ebe0f96..b4d66ba 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,9 +1,9 @@
-source 'http://rubygems.org/'
+source 'https://rubygems.org/'
 
 group :development do
-  gem "RedCloth", "~> 4.2"
-  gem "foreman",  "~> 0.13"
-  gem "serve",    "~> 1.0"
-  gem "jekyll",   "~> 0.10"
-  gem "thin",     "~> 1.2"
+  gem "github-pages"
+  gem "tzinfo-data"
+
+  gem "foreman",  "~> 0.63"
+  gem "serve",    "~> 1.5"
 end
diff --git a/Gemfile.lock b/Gemfile.lock
index 0b46357..d8185b6 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,47 +1,77 @@
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
     RedCloth (4.2.9)
-    activesupport (3.0.7)
+    activesupport (3.2.14)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
     classifier (1.3.3)
       fast-stemmer (>= 1.0.0)
-    daemons (1.1.3)
-    directory_watcher (1.4.0)
-    eventmachine (0.12.10)
-    fast-stemmer (1.0.0)
-    foreman (0.13.0)
-      term-ansicolor (~> 1.0.5)
+    colorator (0.1)
+    commander (4.1.5)
+      highline (~> 1.6.11)
+    directory_watcher (1.4.1)
+    dotenv (0.8.0)
+    fast-stemmer (1.0.2)
+    foreman (0.63.0)
+      dotenv (>= 0.7)
       thor (>= 0.13.6)
-    i18n (0.4.2)
-    jekyll (0.10.0)
-      classifier (>= 1.3.1)
-      directory_watcher (>= 1.1.1)
-      liquid (>= 1.9.0)
-      maruku (>= 0.5.9)
-    liquid (2.2.2)
-    maruku (0.6.0)
+    github-pages (1)
+      RedCloth (= 4.2.9)
+      jekyll (= 1.1.2)
+      kramdown (= 1.0.2)
+      liquid (= 2.5.1)
+      maruku (= 0.6.1)
+      rdiscount (= 1.6.8)
+      redcarpet (= 2.2.2)
+    highline (1.6.19)
+    i18n (0.6.5)
+    jekyll (1.1.2)
+      classifier (~> 1.3)
+      colorator (~> 0.1)
+      commander (~> 4.1.3)
+      directory_watcher (~> 1.4.1)
+      kramdown (~> 1.0.2)
+      liquid (~> 2.5.1)
+      maruku (~> 0.5)
+      pygments.rb (~> 0.5.0)
+      redcarpet (~> 2.2.2)
+      safe_yaml (~> 0.7.0)
+    kramdown (1.0.2)
+    liquid (2.5.1)
+    maruku (0.6.1)
       syntax (>= 1.0.0)
-    rack (1.2.2)
-    serve (1.0.0)
-      activesupport (~> 3.0.1)
-      i18n (~> 0.4.1)
-      rack (~> 1.2.1)
-      tzinfo (~> 0.3.23)
+    multi_json (1.7.9)
+    posix-spawn (0.3.6)
+    pygments.rb (0.5.2)
+      posix-spawn (~> 0.3.6)
+      yajl-ruby (~> 1.1.0)
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rdiscount (1.6.8)
+    redcarpet (2.2.2)
+    safe_yaml (0.7.1)
+    serve (1.5.2)
+      activesupport (~> 3.2.12)
+      i18n
+      rack (~> 1.5.2)
+      rack-test (~> 0.6.2)
+      tilt (~> 1.3.3)
+      tzinfo
     syntax (1.0.0)
-    term-ansicolor (1.0.5)
-    thin (1.2.11)
-      daemons (>= 1.0.9)
-      eventmachine (>= 0.12.6)
-      rack (>= 1.0.0)
-    thor (0.14.6)
-    tzinfo (0.3.27)
+    thor (0.18.1)
+    tilt (1.3.7)
+    tzinfo (1.0.1)
+    tzinfo-data (1.2013.4)
+      tzinfo (>= 1.0.0)
+    yajl-ruby (1.1.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  RedCloth (~> 4.2)
-  foreman (~> 0.13)
-  jekyll (~> 0.10)
-  serve (~> 1.0)
-  thin (~> 1.2)
+  foreman (~> 0.63)
+  github-pages
+  serve (~> 1.5)
+  tzinfo-data

From fffd98eed9629cb74817e6c9bc2d1a7d906b6b20 Mon Sep 17 00:00:00 2001
From: Peter Hellberg <peter@c7.se>
Date: Sun, 18 Aug 2013 14:21:24 +0200
Subject: [PATCH 038/105] Now using the github-pages gem in order to better
 mirror the production environment.

---
 .ruby-gemset  | 1 +
 .ruby-version | 1 +
 Procfile      | 2 +-
 _config.yml   | 2 ++
 4 files changed, 5 insertions(+), 1 deletion(-)
 create mode 100644 .ruby-gemset
 create mode 100644 .ruby-version

diff --git a/.ruby-gemset b/.ruby-gemset
new file mode 100644
index 0000000..119b7fd
--- /dev/null
+++ b/.ruby-gemset
@@ -0,0 +1 @@
+coffeescript-cookbook
diff --git a/.ruby-version b/.ruby-version
new file mode 100644
index 0000000..77fee73
--- /dev/null
+++ b/.ruby-version
@@ -0,0 +1 @@
+1.9.3
diff --git a/Procfile b/Procfile
index c41ebb6..26a670a 100644
--- a/Procfile
+++ b/Procfile
@@ -1,2 +1,2 @@
-jekyll: bundle exec jekyll --auto
+jekyll: bundle exec jekyll build --watch
 serve: bundle exec serve 4000 development _site
diff --git a/_config.yml b/_config.yml
index f61488e..fef8911 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,5 +1,7 @@
+safe: true
 pygments: true
 lsi: false
+markdown: redcarpet
 exclude:
   - README.md
   - CNAME

From 7ebd0275b2c5569b7a5f30723551028d8d8ea6b5 Mon Sep 17 00:00:00 2001
From: Peter Hellberg <peter@c7.se>
Date: Sun, 18 Aug 2013 15:13:54 +0200
Subject: [PATCH 039/105] Updated the Developer's Guide to better reflect the
 current workflow.

---
 developers-guide.md | 54 ++++++++++++++++++++-------------------------
 1 file changed, 24 insertions(+), 30 deletions(-)

diff --git a/developers-guide.md b/developers-guide.md
index 8d8c210..909847e 100644
--- a/developers-guide.md
+++ b/developers-guide.md
@@ -9,7 +9,8 @@ _Please help out by updating this page_
 
 ### Operating System
 
-It works on Mac OSX. Probably works without any changes or issues on linux. A masochist could probably get it working on Windows.
+It works on Mac OSX. Probably works without any changes or issues on Linux.
+A masochist could probably get it working on Windows.
 
 ## Installation
 
@@ -19,54 +20,47 @@ It works on Mac OSX. Probably works without any changes or issues on linux. A ma
 git clone git://github.com/coffeescript-cookbook/coffeescript-cookbook.github.com.git
 {% endhighlight %}
 
-### Create a Ruby Gemset
+### Ruby environment
 
-Optional, but highly recommended.
+You probably want to have [RVM](http://rvm.io/) installed.
 
-{% highlight bash %}
-$ rvm gemset create jekyll
-$ echo 'rvm gemset use jekyll' >> .rvmrc
-{% endhighlight %}
-
-### Install Required Gems
+The project includes a `.ruby-version` file locked to
+*1.9.3* since that is what Github Pages are currently using.
 
-{% highlight bash %}
-gem install jekyll   # needed for testing building the site
-gem install RedCloth # needed for .md rendering
-gem install serve    # needed for resolving .html files w/o extension
-gem install thin     # optional; more efficient webserver than Webrick but not strictly necessary
-{% endhighlight %}
+There is also a `.ruby-gemset` that is set to *coffeescript-cookbook*
 
-### Install pygments
+### Required dependencies
 
-You'll need python installed for this. Macs and most linuces come with it preinstalled.
+We are using [Bundler](http://bundler.io/) to install the required Ruby dependencies.
 
 {% highlight bash %}
-easy_install pygments   # for syntax highlighting
+bundle install
 {% endhighlight %}
 
-## Building and Viewing the Website
-
-### Run jekyll
+#### Install pygments
 
-Open a terminal window, cd into the project folder and run jekyll from the project root.
+You'll need python installed for this.
+Macs and most Linuces come with it preinstalled.
 
 {% highlight bash %}
-jekyll --auto
+easy_install pygments # for syntax highlighting
 {% endhighlight %}
 
-Leave this window running while you work. Any time you change a file, jekyll will rerender it into the `_site` folder.
-
-### Run serve
+## Building and Viewing the Website
 
-Open another terminal window, cd into the project folder, then cd into the `_site` subfolder, and run
+Open a terminal window, cd into the project folder and run `foreman start` from the project root.
 
 {% highlight bash %}
-serve
+foreman start
 {% endhighlight %}
 
-This will start a webserver in the `_site` folder. Open a browser and visit `http://localhost:4000/` and you should see the site.
+Leave this window running while you work.
+Any time you change a file, jekyll will rerender it into the `_site` folder.
+
+Open a browser and visit <http://localhost:4000/> and you should see the site.
 
 ## Minutiae and Other Trivialities
 
-jekyll can take a second or two to catch up when you save a file. If you edit a file and don't see the changes in your browser, give it a second or two and try again. You may also see Maruku warnings, but as long as it prints `Successfully generated site` you should be alright.
+Jekyll can take a second or two to catch up when you save a file. 
+If you edit a file and don't see the changes in your browser, give it a second or two and try again.
+As long as it prints `Successfully generated site` you should be alright.

From 31a0d63425aa933afd11fa3a731fba5d1b06ef77 Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Thu, 5 Sep 2013 18:24:15 +0800
Subject: [PATCH 040/105] Fix 5 typos on the Adapter design pattern page.

---
 chapters/design_patterns/adapter.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index 8be4ece..2d6fc56 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -1,12 +1,12 @@
 ---
 layout: recipe
-title: Adapter patter
+title: Adapter pattern
 chapter: Design patterns
 ---
 ## Problem
 
 Suppose we have 3-rd party grid component. We want to apply there our own custom sorting but a small problem. Our custom sorter does not implement required interface by grid component.
-To understand the problem completely best example would be an socket from our usual life. Everybody knows this device. In some countries it has 3 pins and in other contries it has only 2 pins. 
+To understand the problem completely best example would be an socket from our usual life. Everybody knows this device. In some countries it has 3 pins and in other countries it has only 2 pins. 
 This is exactly right situation to use [adapter pattern](https://en.wikipedia.org/wiki/Adapter_pattern). 
 
 ## Solution
@@ -47,5 +47,5 @@ agrid.sort() # sort data with custom sorter through adapter
 
 ## Discussion
 
-Adapter is usefull when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 
-In any case be carefull with adapter: it can be helpfull but it can instigate design errors. 
+Adapter is useful when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 
+In any case be careful with adapter: it can be helpful but it can instigate design errors. 

From 68aaa998b96077340a707b5ad286e07b405fb061 Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Thu, 5 Sep 2013 18:26:21 +0800
Subject: [PATCH 041/105] Anglicize the problem statement.

---
 chapters/design_patterns/adapter.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index 2d6fc56..19aaca9 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -5,9 +5,12 @@ chapter: Design patterns
 ---
 ## Problem
 
-Suppose we have 3-rd party grid component. We want to apply there our own custom sorting but a small problem. Our custom sorter does not implement required interface by grid component.
-To understand the problem completely best example would be an socket from our usual life. Everybody knows this device. In some countries it has 3 pins and in other countries it has only 2 pins. 
-This is exactly right situation to use [adapter pattern](https://en.wikipedia.org/wiki/Adapter_pattern). 
+Imagine you are traveling to a foreign country and once at your hotel room you realize your power cord is not compatible with the wall electric socket.
+Luckily you remember you brought with you a socket adapter.
+It will connect to the wall socket on one side and to your power cord on the other side, allowing for communication between them.
+
+The same situation may arise in code, when 2 (or more) instances (of classes, modules, etc.) want to talk to each other, but whose communication protocol (e.i. the language they use to communicate) is different from each other.
+In such a situation, the [Adapter Pattern](//en.wikipedia.org/wiki/Adapter_pattern) comes in handy. It will do the translation, from one side to the other.
 
 ## Solution
 
@@ -47,5 +50,5 @@ agrid.sort() # sort data with custom sorter through adapter
 
 ## Discussion
 
-Adapter is useful when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3-rd party libraries  or you work with legacy code. 
+Adapter is useful when you have to organize an interaction between two objects with different interfaces. It can happen when you use 3rd party libraries  or you work with legacy code. 
 In any case be careful with adapter: it can be helpful but it can instigate design errors. 

From 2324b0344fb569798d30db10de69287554826d0a Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Thu, 5 Sep 2013 19:06:11 +0800
Subject: [PATCH 042/105] Bring CoffeeScript idiom to conditional statement.

An advantage of CoffeeScript compared to JavaScript is its ability to
check for array membership with the `in` keyword.
A feature it borrowed from Python.
---
 chapters/ajax/ajax_request_without_jquery.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/ajax/ajax_request_without_jquery.md b/chapters/ajax/ajax_request_without_jquery.md
index 5956548..7f69c93 100644
--- a/chapters/ajax/ajax_request_without_jquery.md
+++ b/chapters/ajax/ajax_request_without_jquery.md
@@ -47,7 +47,7 @@ loadDataFromServer = ->
 
   req.addEventListener 'readystatechange', ->
     if req.readyState is 4                        # ReadyState Compelte
-      if req.status is 200 or req.status is 304   # Success result codes
+      if req.status in [200, 304]   # Success result codes
         data = eval '(' + req.responseText + ')'
         console.log 'data message: ', data.message
       else

From cf2867beba00fe2cc0dbe9bf315086b4b7cd615f Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Thu, 5 Sep 2013 19:29:49 +0800
Subject: [PATCH 043/105] Amount takes only 1 'm'.

---
 chapters/arrays/max-array-value.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/arrays/max-array-value.md b/chapters/arrays/max-array-value.md
index ce3adc1..25f1472 100644
--- a/chapters/arrays/max-array-value.md
+++ b/chapters/arrays/max-array-value.md
@@ -26,4 +26,4 @@ Alternatively, it's possible to use ES5 `reduce` method. For backward compatibil
 
 ## Discussion
 
-`Math.max` compares every argument and returns the largest number from arguments. The ellipsis (`...`) converts every array value into argument which is given to the function. You can also use it with other functions which take variable ammount of arguments, such as `console.log`.
+`Math.max` compares every argument and returns the largest number from arguments. The ellipsis (`...`) converts every array value into argument which is given to the function. You can also use it with other functions which take variable amount of arguments, such as `console.log`.

From 227978f0c15f08ff7b4970cd531f8354e44496c3 Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Thu, 5 Sep 2013 21:29:53 +0800
Subject: [PATCH 044/105] Improve readability.

---
 chapters/ajax/ajax_request_without_jquery.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/chapters/ajax/ajax_request_without_jquery.md b/chapters/ajax/ajax_request_without_jquery.md
index 7f69c93..d95713c 100644
--- a/chapters/ajax/ajax_request_without_jquery.md
+++ b/chapters/ajax/ajax_request_without_jquery.md
@@ -47,7 +47,8 @@ loadDataFromServer = ->
 
   req.addEventListener 'readystatechange', ->
     if req.readyState is 4                        # ReadyState Compelte
-      if req.status in [200, 304]   # Success result codes
+      successResultCodes = [200, 304]
+      if req.status in successResultCodes
         data = eval '(' + req.responseText + ')'
         console.log 'data message: ', data.message
       else

From 026fd00545b36330624e6de3189ee0864ef60539 Mon Sep 17 00:00:00 2001
From: Julien <julien@nepsilon.net>
Date: Sat, 7 Sep 2013 13:21:39 +0800
Subject: [PATCH 045/105] Better rephrase the problem statement.

---
 chapters/design_patterns/adapter.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index 19aaca9..7e2af73 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -5,9 +5,9 @@ chapter: Design patterns
 ---
 ## Problem
 
-Imagine you are traveling to a foreign country and once at your hotel room you realize your power cord is not compatible with the wall electric socket.
-Luckily you remember you brought with you a socket adapter.
-It will connect to the wall socket on one side and to your power cord on the other side, allowing for communication between them.
+Imagine you are traveling to a foreign country and once at your hotel room you realize your power cord socket is not compatible with the wall socket.
+Luckily, you remembered you've brought your power adapter with you.
+It will connect your power cord socket on one side and wall socket on the other side, allowing for communication between them.
 
 The same situation may arise in code, when 2 (or more) instances (of classes, modules, etc.) want to talk to each other, but whose communication protocol (e.i. the language they use to communicate) is different from each other.
 In such a situation, the [Adapter Pattern](//en.wikipedia.org/wiki/Adapter_pattern) comes in handy. It will do the translation, from one side to the other.

From 5f35db8957f5938c27bc9bdf3721a25af075e898 Mon Sep 17 00:00:00 2001
From: Jakob Krigovsky <jakob.krigovsky@gmail.com>
Date: Fri, 13 Sep 2013 19:40:39 +0200
Subject: [PATCH 046/105] =?UTF-8?q?Automatically=20update=20=E2=80=9Clast?=
 =?UTF-8?q?=20updated=E2=80=9D=20date?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 _layouts/chapter.html | 2 +-
 _layouts/default.html | 2 +-
 _layouts/recipe.html  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/_layouts/chapter.html b/_layouts/chapter.html
index b075d2c..2bfe664 100644
--- a/_layouts/chapter.html
+++ b/_layouts/chapter.html
@@ -55,7 +55,7 @@ <h2>{{ page.title }}</h2>
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
           <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
-          <small class="thin dimmed">(last updated 28 August, 2012)</small>
+          <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
 
diff --git a/_layouts/default.html b/_layouts/default.html
index 1f00656..b45615d 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -52,7 +52,7 @@ <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
           <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
-          <small class="thin dimmed">(last updated 28 August, 2012)</small>
+          <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
 
diff --git a/_layouts/recipe.html b/_layouts/recipe.html
index d71dfba..fd6e969 100644
--- a/_layouts/recipe.html
+++ b/_layouts/recipe.html
@@ -54,7 +54,7 @@ <h1>{{ page.title }}</h1>
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
           <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
-          <small class="thin dimmed">(last updated 28 August, 2012)</small>
+          <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
 

From 0776427f49975b494a218e3144be078a7ce714bf Mon Sep 17 00:00:00 2001
From: Calum Robertson <calum.robertson@gmail.com>
Date: Thu, 19 Sep 2013 19:08:22 +0100
Subject: [PATCH 047/105] Added the Template Method Pattern.

---
 authors.md                                  |  1 +
 chapters/design_patterns/template_method.md | 45 +++++++++++++++++++++
 2 files changed, 46 insertions(+)
 create mode 100644 chapters/design_patterns/template_method.md

diff --git a/authors.md b/authors.md
index be4922c..7876aa2 100644
--- a/authors.md
+++ b/authors.md
@@ -21,6 +21,7 @@ The following people are totally rad and awesome because they have contributed r
 * Frederic Hemberger
 * Mike Hatfield *oakraven13@gmail.com*
 * [Anton Rissanen](http://github.com/antris) *hello@anton.fi*
+* Calum Robertson *http://github.com/randusr836*
 * ...You! What are you waiting for? Check out the [contributing](/contributing) section and get cracking!
 
 # Developers
diff --git a/chapters/design_patterns/template_method.md b/chapters/design_patterns/template_method.md
new file mode 100644
index 0000000..607be35
--- /dev/null
+++ b/chapters/design_patterns/template_method.md
@@ -0,0 +1,45 @@
+---
+layout: recipe
+title: Template Method Pattern
+chapter: Design Patterns
+---
+## Problem
+
+You need to execute a series of steps according to some algorithm or recipe and wish to provide the implementation for any of the steps.
+
+## Solution
+
+Use the Template Method to describe each step in a superclass, delegating the implementation of each step to a subclass.
+
+For example, imagine you wish to model various types of document and each one may contain a header and a body.
+
+{% highlight coffeescript %}
+class Document
+	produceDocument: ->
+		@produceHeader()
+		@produceBody()
+
+	produceHeader: ->
+	produceBody: ->
+
+class DocWithHeader extends Document
+	produceHeader: ->
+		console.log "Producing header for DocWithHeader"
+
+	produceBody: ->
+		console.log "Producing body for DocWithHeader"
+
+class DocWithoutHeader extends Document
+	produceBody: ->
+		console.log "Producing body for DocWithoutHeader"
+
+doc1 = new DocWithHeader
+doc1.produceDocument()
+
+doc2 = new DocWithoutHeader
+doc2.produceDocument()
+{% endhighlight %}
+
+## Discussion
+
+In this example, there are two steps, one for producing a document header and the second for producing the document body; these two steps are given empty implementations in the superclass. The DocWithHeader implements both the body and header steps, whereas the DocWithoutHeader only impements the body step.

From 198eed36fca85a819aac55ee534432d4dfcb0b9c Mon Sep 17 00:00:00 2001
From: Calum Robertson <calum.robertson@gmail.com>
Date: Fri, 20 Sep 2013 21:39:13 +0100
Subject: [PATCH 048/105] Changes after feedback. Wrote a little about
 polymorphism being used in the pattern. Described in greater detail the
 concepts of the algorithm structure and the specification of algorithm step
 behaviour.

---
 chapters/design_patterns/template_method.md | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/chapters/design_patterns/template_method.md b/chapters/design_patterns/template_method.md
index 607be35..31fe475 100644
--- a/chapters/design_patterns/template_method.md
+++ b/chapters/design_patterns/template_method.md
@@ -5,13 +5,13 @@ chapter: Design Patterns
 ---
 ## Problem
 
-You need to execute a series of steps according to some algorithm or recipe and wish to provide the implementation for any of the steps.
+Define the structure of an algorithm as a series of high-level steps, making it possible to specify the behaviour of each step, giving rise to a family of algorithms that have the same structure but different behaviours.
 
 ## Solution
 
-Use the Template Method to describe each step in a superclass, delegating the implementation of each step to a subclass.
+Use the Template Method to describe the algorithm structure in a superclass, delegating the implementation of some steps to one or more concrete subclasses.
 
-For example, imagine you wish to model various types of document and each one may contain a header and a body.
+For example, imagine you wish to model the production of various types of document and each one may contain a header and a body.
 
 {% highlight coffeescript %}
 class Document
@@ -33,13 +33,12 @@ class DocWithoutHeader extends Document
 	produceBody: ->
 		console.log "Producing body for DocWithoutHeader"
 
-doc1 = new DocWithHeader
-doc1.produceDocument()
-
-doc2 = new DocWithoutHeader
-doc2.produceDocument()
+docs = [new DocWithHeader, new DocWithoutHeader]
+doc.produceDocument() for doc in docs
 {% endhighlight %}
 
 ## Discussion
 
-In this example, there are two steps, one for producing a document header and the second for producing the document body; these two steps are given empty implementations in the superclass. The DocWithHeader implements both the body and header steps, whereas the DocWithoutHeader only impements the body step.
+In this example, the algorithm consists of two steps describing document production: one for producing a document header and the second for producing the document body. An empty method implementation for each step is present in the superclass and polymorphism is exploited such that each concrete subclass can provide a different implementation for a step by overriding a step method. In this example,the DocWithHeader implements both the body and header steps, whereas the DocWithoutHeader only implements the body step.
+
+The production of different types of document is then straightforward when document objects are stored in an array, and it is then a simple of matter of iterating over each document object and calling its produceDocument method.
\ No newline at end of file

From 2228b639d6e1b06cdb9d15b4a18aa1e971e9b0cf Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Tue, 8 Oct 2013 00:48:21 -0400
Subject: [PATCH 049/105] Changed to best practice of the `this` keyword

I've seen several people on IRC talk about readability. It seems there is some opinions that when chaining like this the `this` keyword is more readable then a dangling `@` symbol.

I think it is a good idea to offer code readability in this project.

Feel free to revert this commit if this is disputed. (Unable to open a PR from in the Github UI).
---
 chapters/classes_and_objects/chaining.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/chapters/classes_and_objects/chaining.md b/chapters/classes_and_objects/chaining.md
index 65f450f..be19212 100644
--- a/chapters/classes_and_objects/chaining.md
+++ b/chapters/classes_and_objects/chaining.md
@@ -20,13 +20,13 @@ class CoffeeCup
 			sugar: false
 	strength: (newStrength) ->
 		@properties.strength = newStrength
-		@
+		this
 	cream: (newCream) ->
 		@properties.cream = newCream
-		@
+		this
 	sugar: (newSugar) ->
 		@properties.sugar = newSugar
-		@
+		this
 
 morningCup = new CoffeeCup()
 

From 5358690140a8d0a8efffe43cf3bac8ccb2857e06 Mon Sep 17 00:00:00 2001
From: Stephen Daves <contact@stephendaves.com>
Date: Tue, 22 Oct 2013 23:20:23 -0600
Subject: [PATCH 050/105] Remove unneeded word

---
 chapters/design_patterns/singleton.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/design_patterns/singleton.md b/chapters/design_patterns/singleton.md
index 18bbf27..6aff70c 100644
--- a/chapters/design_patterns/singleton.md
+++ b/chapters/design_patterns/singleton.md
@@ -12,7 +12,7 @@ Many times you only want one, and only one, instance of a class. For example, yo
 
 The publicly available class only contains the method to get the one true instance. The instance is kept within the closure of that public object and is always returned.
 
-This is works because CoffeeScript allows you to define executable statements inside a class definition. However, because most CoffeeScript compiles into a [IIFE][] wrapper you do not have to place the private class inside the class definition if this style suits you. The later might be useful when developing modular code such as found in [CommonJS][] (Node.js) or [Require.js][] (See the discussion for an example).
+This works because CoffeeScript allows you to define executable statements inside a class definition. However, because most CoffeeScript compiles into a [IIFE][] wrapper you do not have to place the private class inside the class definition if this style suits you. The later might be useful when developing modular code such as found in [CommonJS][] (Node.js) or [Require.js][] (See the discussion for an example).
 
 [IIFE]: http://benalman.com/news/2010/11/immediately-invoked-function-expression/
 [CommonJS]: http://www.commonjs.org/

From 2cc50bce27bbd9f70341678c6acf3c565ed255b9 Mon Sep 17 00:00:00 2001
From: Orban Botond <orbanbotond@gmail.com>
Date: Sun, 3 Nov 2013 15:48:40 +0200
Subject: [PATCH 051/105] FIX #95

---
 chapters/arrays/testing-every-element.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/arrays/testing-every-element.md b/chapters/arrays/testing-every-element.md
index 5978500..4f82c2a 100644
--- a/chapters/arrays/testing-every-element.md
+++ b/chapters/arrays/testing-every-element.md
@@ -12,7 +12,7 @@ You want to be able to check that every element in an array meets a particular c
 Use Array.every (ECMAScript 5):
 
 {% highlight coffeescript %}
-evens = (x for x in [1..10] by 2)
+evens = (x for x in [0..10] by 2)
 
 evens.every (x)-> x % 2 == 0
 # => true

From 2d16a576acd38b3666737d4861aca87652ee3502 Mon Sep 17 00:00:00 2001
From: jlburkhead <jlburkhead@ucdavis.edu>
Date: Sun, 15 Dec 2013 04:49:15 -0500
Subject: [PATCH 052/105] add an example of generating random numbers in an
 arbitrary range

---
 chapters/math/generating-random-numbers.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/chapters/math/generating-random-numbers.md b/chapters/math/generating-random-numbers.md
index f181940..afb1c5c 100644
--- a/chapters/math/generating-random-numbers.md
+++ b/chapters/math/generating-random-numbers.md
@@ -24,6 +24,12 @@ percentile = Math.floor(Math.random() * 100)
 dice = Math.floor(Math.random() * 6) + 1
 1 <= dice <= 6
 # => true
+
+max = 42
+min = -13
+range = Math.random() * (max - min) + min
+-13 <= range < 42
+# => true
 {% endhighlight %}
 
 ## Discussion

From dd4f0b9ea9a60ba4b3d31abe34f92f643074a129 Mon Sep 17 00:00:00 2001
From: jlburkhead <jlburkhead@ucdavis.edu>
Date: Sun, 15 Dec 2013 05:06:33 -0500
Subject: [PATCH 053/105] add recipe on exponents and logarithms

---
 .../working-with-exponents-and-logarithms.md  | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 chapters/math/working-with-exponents-and-logarithms.md

diff --git a/chapters/math/working-with-exponents-and-logarithms.md b/chapters/math/working-with-exponents-and-logarithms.md
new file mode 100644
index 0000000..6891530
--- /dev/null
+++ b/chapters/math/working-with-exponents-and-logarithms.md
@@ -0,0 +1,37 @@
+---
+layout: recipe
+title: Working with Exponents and Logarithms
+chapter: Math
+---
+## Problem
+
+You need to do some calculations that involve exponents and logarithms.
+
+## Solution
+
+Use Javascript's Math object to provide common mathematical functions.
+
+{% highlight coffeescript %}
+# Math.pow(x, y) returns x^y
+Math.pow(2, 4)
+# => 16
+
+# Math.exp(x) returns E^x and is shorthand for Math.pow(Math.E, x)
+Math.exp(2)
+# => 7.38905609893065
+
+# Math.log returns the natural (base E) log
+Math.log(5)
+# => 1.6094379124341003
+Math.log(Math.exp(42))
+# => 42
+
+# To get a log with some other base n, divide by Math.log(n)
+Math.log(100) / Math.log(10)
+# => 2
+
+{% endhighlight %}
+
+## Discussion
+
+For more information on the Math object see the documentation on the [Mozilla Developer Netword](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math). Also refer to [Converting Radians and Degrees](/chapters/math/radians-degrees) for discussion of the various constants in the Math object.

From 658abba3357ff67286019b5a376a0642be341ca3 Mon Sep 17 00:00:00 2001
From: jlburkhead <jlburkhead@ucdavis.edu>
Date: Sun, 15 Dec 2013 15:10:48 -0500
Subject: [PATCH 054/105] fix another typo and link to correct reference

---
 authors.md                                             | 1 +
 chapters/math/working-with-exponents-and-logarithms.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/authors.md b/authors.md
index 7876aa2..70bea43 100644
--- a/authors.md
+++ b/authors.md
@@ -22,6 +22,7 @@ The following people are totally rad and awesome because they have contributed r
 * Mike Hatfield *oakraven13@gmail.com*
 * [Anton Rissanen](http://github.com/antris) *hello@anton.fi*
 * Calum Robertson *http://github.com/randusr836*
+* Jake Burkhead *https://github.com/jlburkhead*
 * ...You! What are you waiting for? Check out the [contributing](/contributing) section and get cracking!
 
 # Developers
diff --git a/chapters/math/working-with-exponents-and-logarithms.md b/chapters/math/working-with-exponents-and-logarithms.md
index 6891530..c8e7c49 100644
--- a/chapters/math/working-with-exponents-and-logarithms.md
+++ b/chapters/math/working-with-exponents-and-logarithms.md
@@ -34,4 +34,4 @@ Math.log(100) / Math.log(10)
 
 ## Discussion
 
-For more information on the Math object see the documentation on the [Mozilla Developer Netword](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math). Also refer to [Converting Radians and Degrees](/chapters/math/radians-degrees) for discussion of the various constants in the Math object.
+For more information on the Math object see the documentation on the [Mozilla Developer Network](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math). Also refer to [Math Constants](/chapters/math/constants) for discussion of the various constants in the Math object.

From 3ff4351575f1dd89e9689a8b78ab7710a0e44961 Mon Sep 17 00:00:00 2001
From: Ayush Gupta <ayush@glugbot.com>
Date: Tue, 18 Mar 2014 17:20:15 +0530
Subject: [PATCH 055/105] updated string interpolation to mention that it works
 only with double quoted strings

---
 chapters/strings/interpolation.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/chapters/strings/interpolation.md b/chapters/strings/interpolation.md
index b1e1e9e..a437be4 100644
--- a/chapters/strings/interpolation.md
+++ b/chapters/strings/interpolation.md
@@ -11,7 +11,8 @@ CoffeeScript Variable.
 ## Solution
 
 Use CoffeeScript's ruby-like string interpolation instead of
-JavaScript's string addition.
+JavaScript's string addition. You must use Double-quoted strings to 
+allow for interpolation. Single-quoted strings are treated as literals.
 
 Interpolation:
 

From dc70747b1a4e8679f975b424311ed9ea08943412 Mon Sep 17 00:00:00 2001
From: Marc Bodmer <marc@500px.com>
Date: Sat, 29 Mar 2014 16:43:43 -0400
Subject: [PATCH 056/105] Remove completed recipes for wanted recipes
 documentation

---
 wanted-recipes.md | 25 +------------------------
 1 file changed, 1 insertion(+), 24 deletions(-)

diff --git a/wanted-recipes.md b/wanted-recipes.md
index 64eec51..5adc15d 100644
--- a/wanted-recipes.md
+++ b/wanted-recipes.md
@@ -8,16 +8,10 @@ Here's a list of recipes we think we need. Pick one, implement it, and remove it
 
 In the notes below, "JS" means the recipe is just a simple passthrough to an existing JavaScript method.
 
-## Introduction
-
-We need a better introduction. Right now the first recipe is [Embedding JavaScript](/chapters/syntax/embedding_javascript), which doesn't set the right first impression. How about three or four recipes that hold new users' hands a bit more as the first section?
-
 ## Syntax
 
 * Ensuring variables are closed over # with "do"
 
-## Objects
-
 ## Strings
 
 * HTML methods # JS .sup(), .sub(), .blink(), .link(url), etc. May not exist in your JS impl!
@@ -45,10 +39,6 @@ evens.every even
 [1..10].some (x) -> x % 2 == 0 # => true
 {% endhighlight %}
 
-## Dates and Times
-
-* Empty
-
 ## Math
 
 * square root # JS Math.sqrt
@@ -89,24 +79,11 @@ foo 1, 2, 3
 # => 6
 {% endhighlight %}
 
-## jQuery
-
-## Regular Expressions
-
-## Networking
-
-* Streaming HTTP server
-* Streaming HTTP client
-
-## AJAX
-
-* Getting data from a remote server # using raw XHTTPRequest instead of jQuery's `$.ajax`
-
 ## Design patterns
 
 * Creational Patterns
   * Abstract Factory
-  * Prototype 
+  * Prototype
 
 * Structural Patterns
   * Adapter

From 6fe6cce0b1776795f516415fced927fab29e2c8a Mon Sep 17 00:00:00 2001
From: Simon Taranto <simon.taranto@gmail.com>
Date: Wed, 2 Apr 2014 10:42:38 -0700
Subject: [PATCH 057/105] Remove duplicate words

---
 chapters/regular_expressions/searching-for-substrings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/regular_expressions/searching-for-substrings.md b/chapters/regular_expressions/searching-for-substrings.md
index 1928591..888c774 100644
--- a/chapters/regular_expressions/searching-for-substrings.md
+++ b/chapters/regular_expressions/searching-for-substrings.md
@@ -23,7 +23,7 @@ match = /sample/i.test("Sample text")
 # => true
 {% endhighlight %}
 
-The next way to is to call the `exec` method on a `RegExp` pattern or object. The `exec` method returns an array an array with the match information or `null`:
+The next way to is to call the `exec` method on a `RegExp` pattern or object. The `exec` method returns an array with the match information or `null`:
 
 {% highlight coffeescript %}
 match = /s(amp)le/i.exec "Sample text"

From 552577922c2209b10ae250926ceb71eb5a4eeb4d Mon Sep 17 00:00:00 2001
From: rdubigny <rdubigny@users.noreply.github.com>
Date: Sat, 5 Apr 2014 17:17:15 +0200
Subject: [PATCH 058/105] Change folder name "tests" -> "test"

I just lost one hour because of that.
---
 chapters/testing/testing_with_nodeunit.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/testing/testing_with_nodeunit.md b/chapters/testing/testing_with_nodeunit.md
index 30af5b8..ec610d2 100644
--- a/chapters/testing/testing_with_nodeunit.md
+++ b/chapters/testing/testing_with_nodeunit.md
@@ -17,7 +17,7 @@ For example, we expect our calculator will be able to add and subtract and will
 
 {% highlight coffeescript %}
 
-# tests/calculator.test.coffee
+# test/calculator.test.coffee
 
 Calculator = require '../calculator'
 

From 91e7d3eb8a49a124896fc3101cd4bd0195928e61 Mon Sep 17 00:00:00 2001
From: Joseph Chiocchi <joe@yolk.cc>
Date: Mon, 7 Apr 2014 17:08:07 -0500
Subject: [PATCH 059/105] fix typo on testing-every-element.md

---
 chapters/arrays/testing-every-element.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/arrays/testing-every-element.md b/chapters/arrays/testing-every-element.md
index 4f82c2a..12b78a1 100644
--- a/chapters/arrays/testing-every-element.md
+++ b/chapters/arrays/testing-every-element.md
@@ -20,7 +20,7 @@ evens.every (x)-> x % 2 == 0
 
 Array.every was addded to Mozilla's Javascript 1.6 and made standard with EcmaScript 5. If you to support browsers that do not implement EC5 then check out [`_.all` from underscore.js][underscore].
 
-For a real world example, prentend you have a multiple select list that looks like:
+For a real world example, pretend you have a multiple select list that looks like:
 
 {% highlight html %}
 <select multiple id="my-select-list">

From 06218c630f05f9944920ad12aaa2ec12dcb5d3b5 Mon Sep 17 00:00:00 2001
From: Charles Lecklider <coffeescript-cookbook@charles.lecklider.org>
Date: Fri, 11 Apr 2014 11:04:34 +0100
Subject: [PATCH 060/105] ignore arrays with fewer than 2 elements

---
 chapters/arrays/shuffling-array-elements.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 6e115da..12fbc16 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -80,9 +80,10 @@ you are able to run it on any array you wish, in a much more direct manner.
 
 {% highlight coffeescript %}
 do -> Array::shuffle ?= ->
-  for i in [@length-1..1]
-    j = Math.floor Math.random() * (i + 1)
-    [@[i], @[j]] = [@[j], @[i]]
+  if @length > 1
+    for i in [@length-1..1]
+      j = Math.floor Math.random() * (i + 1)
+      [@[i], @[j]] = [@[j], @[i]]
   @
 
 [1..9].shuffle()

From b9752d81f2f4f9a387e5ef3071de8ff43a2e068b Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Sat, 10 May 2014 12:23:12 -0400
Subject: [PATCH 061/105] Clean up randomInt example

Based on issue #109, the readability of the `randomInt` was a bit confusing.

Adds some comments to better clarify the logic. Made code more CoffeeScript-ish
---
 chapters/math/random-integer.md | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/chapters/math/random-integer.md b/chapters/math/random-integer.md
index 99cd866..052c8e6 100644
--- a/chapters/math/random-integer.md
+++ b/chapters/math/random-integer.md
@@ -12,13 +12,10 @@ You'd like to get a random integer between two integers, inclusive.
 Use the following function.
 
 {% highlight coffeescript %}
-randomInt = (lower, upper=0) ->
-  start = Math.random()
-  if not lower?
-    [lower, upper] = [0, lower]
-  if lower > upper
-    [lower, upper] = [upper, lower]
-  return Math.floor(start * (upper - lower + 1) + lower)
+randomInt = (lower, upper) ->
+  [lower, upper] = [0, lower]     unless upper?           # Called with one argument
+  [lower, upper] = [upper, lower] if lower > upper        # Lower must be less then upper
+  Math.floor(Math.random() * (upper - lower + 1) + lower) # Last statement is a return value
 
 (randomInt(1) for i in [0...10])
 # => [0,1,1,0,0,0,1,1,1,0]

From 1147e4a4747bf38fe911d33f1003d189a80679f0 Mon Sep 17 00:00:00 2001
From: Mark Koopman <markmontymark@yahoo.com>
Date: Thu, 19 Jun 2014 18:43:28 -0700
Subject: [PATCH 062/105] Aspell mods and a few grammar fixes

---
 authors-guide.md                                     |  4 ++--
 chapters/ajax/ajax_request_without_jquery.md         |  6 +++---
 chapters/arrays/filtering-arrays.md                  |  2 +-
 chapters/arrays/reducing-arrays.md                   |  2 +-
 chapters/arrays/testing-every-element.md             |  2 +-
 chapters/arrays/where-for-arrays-of-objects.md       |  2 +-
 chapters/classes_and_objects/class-variables.md      |  2 +-
 chapters/dates_and_times/date-of-thanksgiving.md     |  2 +-
 chapters/dates_and_times/days-between-two-dates.md   | 10 +++++-----
 chapters/dates_and_times/moon-phase-for-date.md      |  2 +-
 chapters/design_patterns/adapter.md                  |  2 +-
 chapters/design_patterns/decorator.md                |  8 ++++----
 chapters/design_patterns/observer.md                 |  4 ++--
 chapters/design_patterns/singleton.md                |  2 +-
 chapters/functions/debounce.md                       |  2 +-
 chapters/functions/parentheses.md                    |  2 +-
 chapters/math/fast-fibonacci.md                      |  2 +-
 chapters/math/fast-inv-square.md                     | 12 ++++++------
 .../math/generating-predictable-random-numbers.md    |  2 +-
 chapters/math/generating-random-numbers.md           |  2 +-
 chapters/strings/capitalizing-words.md               |  2 +-
 developers-guide.md                                  |  4 ++--
 wanted-recipes.md                                    |  6 +++---
 23 files changed, 42 insertions(+), 42 deletions(-)

diff --git a/authors-guide.md b/authors-guide.md
index f5de511..6c3af27 100644
--- a/authors-guide.md
+++ b/authors-guide.md
@@ -26,7 +26,7 @@ A typical cookbook page will have three sections (four if you count the title):
 
 ## Copyright Issues
 
-Do not post code that is copyrighted by another user, unless you have permission to use that code AND to relicense that code under the [CC BY 3.0](/license) license. If you DO have permission and the author would like credit, please add them to the [authors](/authors) page.
+Do not post code that is copyrighted by another user, unless you have permission to use that code AND to re-license that code under the [CC BY 3.0](/license) license. If you DO have permission and the author would like credit, please add them to the [authors](/authors) page.
 
 Also, just a stylistic note, please do not yank code directly from [http://coffeescript.org/](http://coffeescript.org/) and post it with little or no discussion. The CoffeeScript Cookbook is not affiliated with them. We think they're awesome and want them to like us, too! Make sure that anything taken from [http://coffeescript.org/](http://coffeescript.org/) is permissible use and that it stands alone as a valid recipe. If the recipe is too terse, consider adding more examples and discussion.
 
@@ -163,7 +163,7 @@ If the answer to either question is no, you might have some code that is a "clev
 
 ## What If My Recipe is Inefficient/Too Big/Too Slow?
 
-If it solves a problem to which the alternative is to _not_ solve the problem, share it. Let the reader decide if they want to use it. Sometimes we want tight efficient code, other times we want a robust featureset. If the code has abysmal performance characteristics, be sure to warn the reader in the Discussion.
+If it solves a problem to which the alternative is to _not_ solve the problem, share it. Let the reader decide if they want to use it. Sometimes we want tight efficient code, other times we want a robust feature set. If the code has abysmal performance characteristics, be sure to warn the reader in the Discussion.
 
 ## Can I Edit An Existing Recipe?
 
diff --git a/chapters/ajax/ajax_request_without_jquery.md b/chapters/ajax/ajax_request_without_jquery.md
index d95713c..917cdfa 100644
--- a/chapters/ajax/ajax_request_without_jquery.md
+++ b/chapters/ajax/ajax_request_without_jquery.md
@@ -46,7 +46,7 @@ loadDataFromServer = ->
   req = new XMLHttpRequest()
 
   req.addEventListener 'readystatechange', ->
-    if req.readyState is 4                        # ReadyState Compelte
+    if req.readyState is 4                        # ReadyState Complete
       successResultCodes = [200, 304]
       if req.status in successResultCodes
         data = eval '(' + req.responseText + ')'
@@ -69,13 +69,13 @@ We define our loadDataFromServer callback beginning on line 2.
 
 We create a XMLHttpRequest request object (line 3) and add a *readystatechange* event handler.  This fires whenever the request's readyState changes.
 
-In the event handler we check to see if the readyState = 4, indicating the request has completed.  Then, we check the request status value.  Both 200 or 304 represent a succsessful request.  Anything else represents an error condition.
+In the event handler we check to see if the readyState = 4, indicating the request has completed.  Then, we check the request status value.  Both 200 or 304 represent a successful request.  Anything else represents an error condition.
 
 If the request was indeed successful, we eval the JSON returned from the server and assign it to a data variable.  At this point, we can use the returned data in any way we need to.
 
 The last thing we need to do is actually make our request.
 
-Line 13 opens a 'GET' request to retreive the data.json file.
+Line 13 opens a 'GET' request to retrieve the data.json file.
 
 Line 14 sends our request to the server. 
 
diff --git a/chapters/arrays/filtering-arrays.md b/chapters/arrays/filtering-arrays.md
index 1d2c7e3..2476aea 100644
--- a/chapters/arrays/filtering-arrays.md
+++ b/chapters/arrays/filtering-arrays.md
@@ -18,7 +18,7 @@ array.filter (x) -> x > 5
 # => [6,7,8,9,10]
 {% endhighlight %}
 
-In pre-EC5 implementations, extend the Array prototype to add a filter function which will take a callback and perform a comprension over itself, collecting all elements for which the callback is true. Be sure to check if the function is already implemented before overwriting it:
+In pre-EC5 implementations, extend the Array prototype to add a filter function which will take a callback and perform a comprehension over itself, collecting all elements for which the callback is true. Be sure to check if the function is already implemented before overwriting it:
 
 {% highlight coffeescript %}
 # Extending Array's prototype
diff --git a/chapters/arrays/reducing-arrays.md b/chapters/arrays/reducing-arrays.md
index c790967..37d5e98 100644
--- a/chapters/arrays/reducing-arrays.md
+++ b/chapters/arrays/reducing-arrays.md
@@ -9,7 +9,7 @@ You have an array of objects and want to reduce them to a value, similar to Ruby
 
 ## Solution
 
-You can simply use Array's `reduce()` and `reduceRight()` methods along with an anonoymous function, keeping the code clean and readable. The reduction may be something simple such as using the `+` operator with numbers or strings.
+You can simply use Array's `reduce()` and `reduceRight()` methods along with an anonymous function, keeping the code clean and readable. The reduction may be something simple such as using the `+` operator with numbers or strings.
 
 {% highlight coffeescript %}
 [1,2,3,4].reduce (x,y) -> x + y
diff --git a/chapters/arrays/testing-every-element.md b/chapters/arrays/testing-every-element.md
index 12b78a1..773a107 100644
--- a/chapters/arrays/testing-every-element.md
+++ b/chapters/arrays/testing-every-element.md
@@ -18,7 +18,7 @@ evens.every (x)-> x % 2 == 0
 # => true
 {% endhighlight %}
 
-Array.every was addded to Mozilla's Javascript 1.6 and made standard with EcmaScript 5. If you to support browsers that do not implement EC5 then check out [`_.all` from underscore.js][underscore].
+Array.every was added to Mozilla's Javascript 1.6 and made standard with ECMAScript 5. If you to support browsers that do not implement EC5 then check out [`_.all` from underscore.js][underscore].
 
 For a real world example, pretend you have a multiple select list that looks like:
 
diff --git a/chapters/arrays/where-for-arrays-of-objects.md b/chapters/arrays/where-for-arrays-of-objects.md
index 51eba6d..99cb556 100644
--- a/chapters/arrays/where-for-arrays-of-objects.md
+++ b/chapters/arrays/where-for-arrays-of-objects.md
@@ -77,4 +77,4 @@ cats.where name:"bubbles", (a, b) -> "#{ a }".toLowerCase() is "#{ b }".toLowerC
 # now it's case insensitive
 {% endhighlight %}
 
-it's more a method to deal with collection and it could be rename as "find" but popular libraires like underscore or lodash name it "where". 
+it's more a method to deal with collection and it could be rename as "find" but popular libraries like underscore or lodash name it "where". 
diff --git a/chapters/classes_and_objects/class-variables.md b/chapters/classes_and_objects/class-variables.md
index dd8713f..1e31b5e 100644
--- a/chapters/classes_and_objects/class-variables.md
+++ b/chapters/classes_and_objects/class-variables.md
@@ -40,4 +40,4 @@ zoo.helpfulInfo()
 
 ## Discussion
 
-Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overrided by instance attribute variables.
+Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overridden by instance attribute variables.
diff --git a/chapters/dates_and_times/date-of-thanksgiving.md b/chapters/dates_and_times/date-of-thanksgiving.md
index 5438244..a26b36c 100644
--- a/chapters/dates_and_times/date-of-thanksgiving.md
+++ b/chapters/dates_and_times/date-of-thanksgiving.md
@@ -5,7 +5,7 @@ chapter: Dates and Times
 ---
 ## Problem
 
-You need to calculate when is Thanksgivinig in given year.
+You need to calculate when Thanksgiving is in a given year.
 
 ## Solution
 
diff --git a/chapters/dates_and_times/days-between-two-dates.md b/chapters/dates_and_times/days-between-two-dates.md
index 0f5c789..11f6894 100644
--- a/chapters/dates_and_times/days-between-two-dates.md
+++ b/chapters/dates_and_times/days-between-two-dates.md
@@ -9,7 +9,7 @@ You need to find how much seconds minutes, hours, days, months or years has pass
 
 ## Solution
 
-Use JavaScript's Date function  getTime(). Which provides how much time in miliseconds has passed since 01/01/1970:
+Use JavaScript's Date function  getTime(). Which provides how much time in milliseconds has passed since 01/01/1970:
 
 {% highlight coffeescript %}
 DAY = 1000 * 60 * 60  * 24
@@ -22,12 +22,12 @@ days_passed = Math.round((d2.getTime() - d1.getTime()) / DAY)
 
 ## Discussion
 
-Using miliseconds makes the life easier to avoid overflow mistakes with Dates. So we first calculate how much miliseconds has a day.
-Then, given two distincit dates, just get the diference in miliseconds betwen two dates and then divide by how much miliseconds has a
+Using milliseconds makes the life easier to avoid overflow mistakes with Dates. So we first calculate how much milliseconds has a day.
+Then, given two distinct dates, just get the difference in milliseconds between two dates and then divide by how much milliseconds has a
 day. It will get you the days between two distinct dates.
 
-If you'd like to calculate the hours between two dates objects you can do that just by dividing the diference in miliseconds by the
-convertion of miliseconds to hours. The same goes to minutes and seconds.
+If you'd like to calculate the hours between two date objects, you can do that just by dividing the difference in milliseconds by the
+conversion of milliseconds to hours. The same goes for minutes and seconds.
 
 {% highlight coffeescript %}
 HOUR = 1000 * 60 * 60
diff --git a/chapters/dates_and_times/moon-phase-for-date.md b/chapters/dates_and_times/moon-phase-for-date.md
index 2c63e61..c97d444 100644
--- a/chapters/dates_and_times/moon-phase-for-date.md
+++ b/chapters/dates_and_times/moon-phase-for-date.md
@@ -9,7 +9,7 @@ You want to find the current phase of the moon.
 
 ## Solution
 
-The following code provides a method to calcualate the phase of the moon for a given date.
+The following code provides a method to calculate the phase of the moon for a given date.
 
 {% highlight coffeescript %}
 # moonPhase.coffee
diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index 7e2af73..bcf4544 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -19,7 +19,7 @@ In such a situation, the [Adapter Pattern](//en.wikipedia.org/wiki/Adapter_patte
 class AwesomeGrid
 	constructor: (@datasource)->
 		@sort_order = 'ASC' 
-		@sorter = new NullSorter # in this place we use NullObject pattern (another usefull pattern)
+		@sorter = new NullSorter # in this place we use NullObject pattern (another useful pattern)
 	setCustomSorter: (@customSorter) ->
 		@sorter = customSorter
 	sort: () ->
diff --git a/chapters/design_patterns/decorator.md b/chapters/design_patterns/decorator.md
index a40ed5c..854f202 100644
--- a/chapters/design_patterns/decorator.md
+++ b/chapters/design_patterns/decorator.md
@@ -71,18 +71,18 @@ The TextProcessor serves the role of Decorator by binding the individual, specia
 We can even modify the existing Decorator object on the fly:
 
 {% highlight coffeescript %}
-smilies =
+smiles =
     ':)' : "smile"
     ':D' : "huge_grin"
     ':(' : "frown"
     ';)' : "wink"
 
-smilieExpander = (line) ->
+smileExpander = (line) ->
     if line
-        (line = line.replace symbol, "<img src='#{text}.png' alt='#{text}' />") for symbol, text of smilies
+        (line = line.replace symbol, "<img src='#{text}.png' alt='#{text}' />") for symbol, text of smiles
     line
 
-processor.processors.unshift smilieExpander
+processor.processors.unshift smileExpander
 
 processor.processString "# A header that makes you :) // you may even laugh"
 
diff --git a/chapters/design_patterns/observer.md b/chapters/design_patterns/observer.md
index f796b78..48047bb 100644
--- a/chapters/design_patterns/observer.md
+++ b/chapters/design_patterns/observer.md
@@ -42,6 +42,6 @@ postOffice.notifyNewItemReleased "Mens Health"
 ## Discussion
 
 Here you have an observer object (PostOffice) and observable objects (MagazineSubscriber, NewspaperSubscriber).
-To be notified about an event of publishing new periodical observable object should make subscribtion on PostOffice.
-Every of subscribed objects is stored internaly in the PostOffice array of subscribtions.
+To be notified about an event of publishing new periodical observable object should make subscription on PostOffice.
+Every of subscribed objects is stored internally in the PostOffice array of subscriptions.
 Every subscriber is notified on new concrete periodical is published.
diff --git a/chapters/design_patterns/singleton.md b/chapters/design_patterns/singleton.md
index 6aff70c..aef94dc 100644
--- a/chapters/design_patterns/singleton.md
+++ b/chapters/design_patterns/singleton.md
@@ -49,7 +49,7 @@ Singleton.PrivateClass # => undefined
 
 ## Discussion
 
-See in the above example how all instances are outputting from the same instance of the Singleton class. You can also see that the PrivateClass and instance variable are not accessible outside the Singleton class. In essance the Singleton class provides a static method get which returns only one instance of PrivateClass and only one. It also hides the PrivateClass from the world so that you can not create your own.
+See in the above example how all instances are outputting from the same instance of the Singleton class. You can also see that the PrivateClass and instance variable are not accessible outside the Singleton class. In essence the Singleton class provides a static method get which returns only one instance of PrivateClass and only one. It also hides the PrivateClass from the world so that you can not create your own.
 
 The idea of hiding or making private the inner workings is preference. Especially since by default CoffeeScript wraps the compiled code inside it's own IIFE (closure) allowing you to define classes without worry that it might be accessible from outside the file. In this example, note that I am using the idiomatic module export feature to emphasize the publicly accessible portion of the module. (See this discussion for further explanation on [exporting to the global namespace][1]).
 
diff --git a/chapters/functions/debounce.md b/chapters/functions/debounce.md
index 2a3b714..19d99a6 100644
--- a/chapters/functions/debounce.md
+++ b/chapters/functions/debounce.md
@@ -34,7 +34,7 @@ mouseMoveHandler: (e) ->
 
 someOtherHandler: (e) ->
   @debounce((e) ->
-    # Do something here, but only once 250 milliseconds after initial execuction.
+    # Do something here, but only once 250 milliseconds after initial execution.
   250, true)
 {% endhighlight %}
 
diff --git a/chapters/functions/parentheses.md b/chapters/functions/parentheses.md
index 3988247..457cd04 100644
--- a/chapters/functions/parentheses.md
+++ b/chapters/functions/parentheses.md
@@ -34,7 +34,7 @@ if (condition) {
 
 Like Ruby, CoffeeScript allows you to drop parentheses to method calls. Unlike Ruby, however, CoffeeScript treats a bare function name as the pointer to the function. The practical upshot of this is that if you give no arguments to a method, CoffeeScript cannot tell if you want to call the function or use it as a reference.
 
-Is this good or bad? It's just different. It creates an unexpected syntax case -- parentheses aren't _always_ optional -- but in exchange it gives you the ability to pass and receive functions fluently by name, something that's a bit klunky in Ruby.
+Is this good or bad? It's just different. It creates an unexpected syntax case -- parentheses aren't _always_ optional -- but in exchange it gives you the ability to pass and receive functions fluently by name, something that's a bit clunky in Ruby.
 
 This usage of the do-notation is a neat approach for CoffeeScript with parenphobia.
 Some people simply prefer to write out the parentheses in the function call, though.
diff --git a/chapters/math/fast-fibonacci.md b/chapters/math/fast-fibonacci.md
index 024773f..a6a54c4 100644
--- a/chapters/math/fast-fibonacci.md
+++ b/chapters/math/fast-fibonacci.md
@@ -34,7 +34,7 @@ This CoffeeScript Javascript Fast Fibonacci code is
 based on the python code from Robin Houston's blog.
 See below links.
 
-A few things I want to introduce in time are implementions of
+A few things I want to introduce in time are implementations of
 Newtonian, Burnikel / Ziegler, and Binet's algorithms on top
 of a Big Number framework.
 
diff --git a/chapters/math/fast-inv-square.md b/chapters/math/fast-inv-square.md
index 0aadaae..328df01 100644
--- a/chapters/math/fast-inv-square.md
+++ b/chapters/math/fast-inv-square.md
@@ -17,16 +17,16 @@ In this CoffeeScript variant I supply the original classic, and newer optimal
 sized magic number.
 
 Another feature included is the ability to alter the level of precision.
-This is done by controling the number of iterations for performing [Newton's
+This is done by controlling the number of iterations for performing [Newton's
 method][3].
 
-Depending on the machine and level of percision this algorithm may still
+Depending on the machine and level of precision this algorithm may still
 provide performance increases over the classic.
 
 To run this, compile the script with coffee:
     coffee -c script.coffee
 
-Then copy & paste the compiled js code in to the JavaSript console of your
+Then copy & paste the compiled js code in to the JavaScript console of your
 browser.
 
 Note: You will need a browser which supports [typed-arrays][4].
@@ -63,16 +63,16 @@ In this CoffeeScript variant I supply the original classic, and newer optimal
 sized magic number.
 
 Another feature included is the ability to alter the level of precision.
-This is done by controling the number of iterations for performing Newton's
+This is done by controlling the number of iterations for performing Newton's
 method[3].
 
-Depending on the machine and level of percision this algorithm may still
+Depending on the machine and level of precision this algorithm may still
 provide performance increases over the classic.
 
 To run this, compile the script with coffee:
     coffee -c <this script>.coffee
 
-Then copy & paste the compiled js code in to the JavaSript console of your
+Then copy & paste the compiled js code in to the JavaScript console of your
 browser.
 
 Note: You will need a browser which supports typed-arrays[4].
diff --git a/chapters/math/generating-predictable-random-numbers.md b/chapters/math/generating-predictable-random-numbers.md
index 128bc61..c4f01c2 100644
--- a/chapters/math/generating-predictable-random-numbers.md
+++ b/chapters/math/generating-predictable-random-numbers.md
@@ -46,7 +46,7 @@ class Rand
 
 ## Discussion
 
-JavaScript and CoffeeScript do not provide a seedable random number generator. Writing your own will be an exercise in trading off the amount of randomness with the simplicity of the generator. A full discussion of randomness is beyond the scope of this cookbook; for further reading consult Donald Knuth's _The Art of Computer Programming_, Volume II, Chapter 3, "Random Numbers", and _Numerical Recipes in C_, 2nd Edition, Chapter 7, "Random Numbers".
+JavaScript and CoffeeScript do not provide a seed-able random number generator. Writing your own will be an exercise in trading off the amount of randomness with the simplicity of the generator. A full discussion of randomness is beyond the scope of this cookbook; for further reading consult Donald Knuth's _The Art of Computer Programming_, Volume II, Chapter 3, "Random Numbers", and _Numerical Recipes in C_, 2nd Edition, Chapter 7, "Random Numbers".
 
 A brief explanation of this random number generator is in order, however. It is a Linear Congruential Pseudorandom Number Generator. LCPRNG's operate on the mathematical formula `I<sub>j+1</sub> = (aI<sub>j</sub>+c) % m`, where a is the multiplier, c is the addition offset, and m is the modulus.
  Each time a random number is requested, a very large multiplication and addition are performed -- "very large" relative to the key space -- and the resulting number is modulused back down into the keyspace.
diff --git a/chapters/math/generating-random-numbers.md b/chapters/math/generating-random-numbers.md
index afb1c5c..e795652 100644
--- a/chapters/math/generating-random-numbers.md
+++ b/chapters/math/generating-random-numbers.md
@@ -36,6 +36,6 @@ range = Math.random() * (max - min) + min
 
 This is a straight lift from JavaScript.
 
-Note that JavaScripts's Math.random() does not allow you to seed the random number generator to force certain values. See [Generating Predictable Random Numbers](/chapters/math/generating-predictable-random-numbers) for that.
+Note that JavaScript's Math.random() does not allow you to seed the random number generator to force certain values. See [Generating Predictable Random Numbers](/chapters/math/generating-predictable-random-numbers) for that.
 
 To generate a number from 0 up to (but not including) n, multiply by n. To generate a number from 1 to n (inclusive), multiply by n and add 1.
diff --git a/chapters/strings/capitalizing-words.md b/chapters/strings/capitalizing-words.md
index 5df2e96..17854d6 100644
--- a/chapters/strings/capitalizing-words.md
+++ b/chapters/strings/capitalizing-words.md
@@ -25,7 +25,7 @@ Or do the same thing using a list comprehension:
 
 ## Discussion
 
-Split, map, join is a common scripting pattern dating back to perl. This function may benefit from being placed directly onto the String class by [Extending Classes](/chapters/objects/extending-classes).
+Split, map, join is a common scripting pattern dating back to Perl. This function may benefit from being placed directly onto the String class by [Extending Classes](/chapters/objects/extending-classes).
 
 Be aware that two wrinkles can appear in the split, map, join pattern. The first is that the split text works best when it is constant. If the source string has multiple spaces in it, the split will need to take this into account to prevent getting extra, empty words. One way to do this is with a regular expression to split on runs of whitespace instead of a single space:
 
diff --git a/developers-guide.md b/developers-guide.md
index 909847e..ab52d6f 100644
--- a/developers-guide.md
+++ b/developers-guide.md
@@ -40,7 +40,7 @@ bundle install
 #### Install pygments
 
 You'll need python installed for this.
-Macs and most Linuces come with it preinstalled.
+Macs and most Linuces come with it pre-installed.
 
 {% highlight bash %}
 easy_install pygments # for syntax highlighting
@@ -55,7 +55,7 @@ foreman start
 {% endhighlight %}
 
 Leave this window running while you work.
-Any time you change a file, jekyll will rerender it into the `_site` folder.
+Any time you change a file, jekyll will re-render it into the `_site` folder.
 
 Open a browser and visit <http://localhost:4000/> and you should see the site.
 
diff --git a/wanted-recipes.md b/wanted-recipes.md
index 5adc15d..4a38f1e 100644
--- a/wanted-recipes.md
+++ b/wanted-recipes.md
@@ -6,7 +6,7 @@ title: Wanted Recipes
 
 Here's a list of recipes we think we need. Pick one, implement it, and remove it from the page. Alternately, add a quick note here for a recipe you'd like to see so someone else can add it.
 
-In the notes below, "JS" means the recipe is just a simple passthrough to an existing JavaScript method.
+In the notes below, "JS" means the recipe is just a simple pass-through to an existing JavaScript method.
 
 ## Syntax
 
@@ -14,7 +14,7 @@ In the notes below, "JS" means the recipe is just a simple passthrough to an exi
 
 ## Strings
 
-* HTML methods # JS .sup(), .sub(), .blink(), .link(url), etc. May not exist in your JS impl!
+* HTML methods # JS .sup(), .sub(), .blink(), .link(url), etc. May not exist in your JS implementation!
 * substr
 {% highlight coffeescript %}
 str.substr(x,y)  === str[x..x+y-1] === str[x...x+y]
@@ -48,7 +48,7 @@ evens.every even
 * Logarithms # Math.log
 * Finding the base-n log # Math.log(num) / Math.log(base)
 * Exponents # Math.exp
-* Check if a creditcard is valid (checksum, Luhn algorithm)
+* Check if a credit card is valid (checksum, Luhn algorithm)
 
 ## Functions
 

From 04c8944bb738657e64461d9343cd86a61856cd70 Mon Sep 17 00:00:00 2001
From: Mark Koopman <markmontymark@yahoo.com>
Date: Tue, 24 Jun 2014 14:35:24 -0700
Subject: [PATCH 063/105] Revert spelling of smilies to smiles, now it stays as
 smilies

---
 chapters/design_patterns/decorator.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/chapters/design_patterns/decorator.md b/chapters/design_patterns/decorator.md
index 854f202..a40ed5c 100644
--- a/chapters/design_patterns/decorator.md
+++ b/chapters/design_patterns/decorator.md
@@ -71,18 +71,18 @@ The TextProcessor serves the role of Decorator by binding the individual, specia
 We can even modify the existing Decorator object on the fly:
 
 {% highlight coffeescript %}
-smiles =
+smilies =
     ':)' : "smile"
     ':D' : "huge_grin"
     ':(' : "frown"
     ';)' : "wink"
 
-smileExpander = (line) ->
+smilieExpander = (line) ->
     if line
-        (line = line.replace symbol, "<img src='#{text}.png' alt='#{text}' />") for symbol, text of smiles
+        (line = line.replace symbol, "<img src='#{text}.png' alt='#{text}' />") for symbol, text of smilies
     line
 
-processor.processors.unshift smileExpander
+processor.processors.unshift smilieExpander
 
 processor.processString "# A header that makes you :) // you may even laugh"
 

From d7945296aa1027c0d9bb9806122d1310b67f1b32 Mon Sep 17 00:00:00 2001
From: Mark Koopman <markmontymark@yahoo.com>
Date: Tue, 24 Jun 2014 14:39:19 -0700
Subject: [PATCH 064/105] Revert commits wrt to "closed compounds" comment

---
 authors-guide.md                                       | 2 +-
 chapters/math/generating-predictable-random-numbers.md | 2 +-
 developers-guide.md                                    | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/authors-guide.md b/authors-guide.md
index 6c3af27..54c1b26 100644
--- a/authors-guide.md
+++ b/authors-guide.md
@@ -26,7 +26,7 @@ A typical cookbook page will have three sections (four if you count the title):
 
 ## Copyright Issues
 
-Do not post code that is copyrighted by another user, unless you have permission to use that code AND to re-license that code under the [CC BY 3.0](/license) license. If you DO have permission and the author would like credit, please add them to the [authors](/authors) page.
+Do not post code that is copyrighted by another user, unless you have permission to use that code AND to relicense that code under the [CC BY 3.0](/license) license. If you DO have permission and the author would like credit, please add them to the [authors](/authors) page.
 
 Also, just a stylistic note, please do not yank code directly from [http://coffeescript.org/](http://coffeescript.org/) and post it with little or no discussion. The CoffeeScript Cookbook is not affiliated with them. We think they're awesome and want them to like us, too! Make sure that anything taken from [http://coffeescript.org/](http://coffeescript.org/) is permissible use and that it stands alone as a valid recipe. If the recipe is too terse, consider adding more examples and discussion.
 
diff --git a/chapters/math/generating-predictable-random-numbers.md b/chapters/math/generating-predictable-random-numbers.md
index c4f01c2..128bc61 100644
--- a/chapters/math/generating-predictable-random-numbers.md
+++ b/chapters/math/generating-predictable-random-numbers.md
@@ -46,7 +46,7 @@ class Rand
 
 ## Discussion
 
-JavaScript and CoffeeScript do not provide a seed-able random number generator. Writing your own will be an exercise in trading off the amount of randomness with the simplicity of the generator. A full discussion of randomness is beyond the scope of this cookbook; for further reading consult Donald Knuth's _The Art of Computer Programming_, Volume II, Chapter 3, "Random Numbers", and _Numerical Recipes in C_, 2nd Edition, Chapter 7, "Random Numbers".
+JavaScript and CoffeeScript do not provide a seedable random number generator. Writing your own will be an exercise in trading off the amount of randomness with the simplicity of the generator. A full discussion of randomness is beyond the scope of this cookbook; for further reading consult Donald Knuth's _The Art of Computer Programming_, Volume II, Chapter 3, "Random Numbers", and _Numerical Recipes in C_, 2nd Edition, Chapter 7, "Random Numbers".
 
 A brief explanation of this random number generator is in order, however. It is a Linear Congruential Pseudorandom Number Generator. LCPRNG's operate on the mathematical formula `I<sub>j+1</sub> = (aI<sub>j</sub>+c) % m`, where a is the multiplier, c is the addition offset, and m is the modulus.
  Each time a random number is requested, a very large multiplication and addition are performed -- "very large" relative to the key space -- and the resulting number is modulused back down into the keyspace.
diff --git a/developers-guide.md b/developers-guide.md
index ab52d6f..909847e 100644
--- a/developers-guide.md
+++ b/developers-guide.md
@@ -40,7 +40,7 @@ bundle install
 #### Install pygments
 
 You'll need python installed for this.
-Macs and most Linuces come with it pre-installed.
+Macs and most Linuces come with it preinstalled.
 
 {% highlight bash %}
 easy_install pygments # for syntax highlighting
@@ -55,7 +55,7 @@ foreman start
 {% endhighlight %}
 
 Leave this window running while you work.
-Any time you change a file, jekyll will re-render it into the `_site` folder.
+Any time you change a file, jekyll will rerender it into the `_site` folder.
 
 Open a browser and visit <http://localhost:4000/> and you should see the site.
 

From f1636397037f19dc49b6ff06896441ed45b9ba31 Mon Sep 17 00:00:00 2001
From: Zach Boatrite <zach@tenforwardconsulting.com>
Date: Sat, 12 Jul 2014 11:56:26 -0500
Subject: [PATCH 065/105] Fix grammar

Change 'You want to create a class methods and instance methods'
to 'You want to create class and instance methods'
---
 .../classes_and_objects/class-methods-and-instance-methods.md   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/classes_and_objects/class-methods-and-instance-methods.md b/chapters/classes_and_objects/class-methods-and-instance-methods.md
index 36960b3..02b3c30 100644
--- a/chapters/classes_and_objects/class-methods-and-instance-methods.md
+++ b/chapters/classes_and_objects/class-methods-and-instance-methods.md
@@ -5,7 +5,7 @@ chapter: Classes and Objects
 ---
 ## Problem
 
-You want to create a class methods and instance methods.
+You want to create class and instance methods.
 
 ## Solution
 

From 2f4e0ef32a02fe9a3dcf4822e84670549c0b803a Mon Sep 17 00:00:00 2001
From: Andrew Turner <andrew.turner@sq1.com>
Date: Mon, 21 Jul 2014 16:25:47 -0500
Subject: [PATCH 066/105] typo/incorrect word usage

reference definition http://www.oxforddictionaries.com/us/definition/american_english/overwrite
---
 chapters/classes_and_objects/class-variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/classes_and_objects/class-variables.md b/chapters/classes_and_objects/class-variables.md
index dd8713f..9d403ef 100644
--- a/chapters/classes_and_objects/class-variables.md
+++ b/chapters/classes_and_objects/class-variables.md
@@ -40,4 +40,4 @@ zoo.helpfulInfo()
 
 ## Discussion
 
-Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overrided by instance attribute variables.
+Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overwritten by instance attribute variables.

From db096ce67e30f2c577f1aa3500df1adbbaffddb3 Mon Sep 17 00:00:00 2001
From: rphv <perry.hooker@gmail.com>
Date: Fri, 25 Jul 2014 17:54:58 -0600
Subject: [PATCH 067/105] Set the default write concern on mongo.Db client

---
 chapters/databases/mongodb.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/chapters/databases/mongodb.md b/chapters/databases/mongodb.md
index 74c4643..161ec6f 100644
--- a/chapters/databases/mongodb.md
+++ b/chapters/databases/mongodb.md
@@ -23,7 +23,7 @@ mongo = require 'mongodb'
 
 server = new mongo.Server "127.0.0.1", 27017, {}
 
-client = new mongo.Db 'test', server
+client = new mongo.Db 'test', server, {w:1}
 
 # save() updates existing records or inserts new ones as needed
 exampleSave = (dbErr, collection) ->
@@ -43,7 +43,7 @@ mongo = require 'mongodb'
 
 server = new mongo.Server "127.0.0.1", 27017, {}
 
-client = new mongo.Db 'test', server
+client = new mongo.Db 'test', server, {w:1}
 
 exampleFind = (dbErr, collection) ->
 	console.log "Unable to access database: #{dbErr}" if dbErr

From b3710c3fec4e45d238e408b49e0f7b1cd92ecd33 Mon Sep 17 00:00:00 2001
From: Janos Csikos <janos@csikos.co.uk>
Date: Thu, 21 Aug 2014 14:56:16 +0100
Subject: [PATCH 068/105] Update outdated external link to an article

Fixing the broken link to "Extending built-in native objects. Evil or not?" article.
---
 chapters/metaprogramming/extending-built-in-objects.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/metaprogramming/extending-built-in-objects.md b/chapters/metaprogramming/extending-built-in-objects.md
index 93b6b58..24eeab8 100644
--- a/chapters/metaprogramming/extending-built-in-objects.md
+++ b/chapters/metaprogramming/extending-built-in-objects.md
@@ -23,4 +23,4 @@ String::capitalize = () ->
 
 Objects in JavaScript (and thus, in CoffeeScript) have a prototype member that defines what member functions should be available on all objects based on that prototype. In CoffeeScript, you can access the prototype directly via the `::` operator.
 
-**Note:** Although it's quite common in languages like Ruby, extending native objects is often considered bad practice in JavaScript (see: [Maintainable JavaScript: Don’t modify objects you don’t own](http://www.nczonline.net/blog/2010/03/02/maintainable-javascript-dont-modify-objects-you-down-own/); [Extending built-in native objects. Evil or not?](http://perfectionkills.com/extending-built-in-native-objects-evil-or-not/)).
+**Note:** Although it's quite common in languages like Ruby, extending native objects is often considered bad practice in JavaScript (see: [Maintainable JavaScript: Don’t modify objects you don’t own](http://www.nczonline.net/blog/2010/03/02/maintainable-javascript-dont-modify-objects-you-down-own/); [Extending built-in native objects. Evil or not?](http://perfectionkills.com/extending-native-builtins/)).

From 65118b76d97fa0a93766b7fedeb1d49dc4dad14d Mon Sep 17 00:00:00 2001
From: Anika Tabassum <anika.tabassum@mail.mcgill.ca>
Date: Sat, 6 Sep 2014 15:13:04 -0400
Subject: [PATCH 069/105] Update type-function link

---
 chapters/classes_and_objects/type-function.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/classes_and_objects/type-function.md b/chapters/classes_and_objects/type-function.md
index 96e8cea..d9355c0 100644
--- a/chapters/classes_and_objects/type-function.md
+++ b/chapters/classes_and_objects/type-function.md
@@ -30,7 +30,7 @@ Use the following function:
 
 ## Discussion
 
-This function was modeled on jQuery's $.type function. (http://api.jquery.com/jQuery.type/)
+This function was modeled on jQuery's [$.type function](http://api.jquery.com/jQuery.type/). 
 
 Note that, as an alternative to type checking, you can often use duck typing and the existential operator together to eliminating the need to examine an object's type, in certain cases.  For example, here is exception-free code that pushes an element to an array, if myArray is in fact an array (or array-like, with a push function), and does nothing otherwise.
 

From b29e38983c38978541ea371d7ec009ce18431c01 Mon Sep 17 00:00:00 2001
From: Dave Powers <djpowers@users.noreply.github.com>
Date: Sun, 7 Sep 2014 11:14:05 -0400
Subject: [PATCH 070/105] Update links to Jasmine web site

Link directly to Jasmine documentation, rather than an old link that redirects. Link to Jasmine repo per the "Standalone Release" links per Jasmine docs.
---
 chapters/testing/testing_with_jasmine.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/chapters/testing/testing_with_jasmine.md b/chapters/testing/testing_with_jasmine.md
index 4dfffb9..9d77961 100644
--- a/chapters/testing/testing_with_jasmine.md
+++ b/chapters/testing/testing_with_jasmine.md
@@ -5,7 +5,7 @@ chapter: Testing
 ---
 ## Problem
 
-You are writing a simple calculator using CoffeeScript and you want to verify it functions as expected.  You decide to use the <a href="http://pivotal.github.com/jasmine/" target="_blank">Jasmine</a> test framework.
+You are writing a simple calculator using CoffeeScript and you want to verify it functions as expected.  You decide to use the <a href="http://jasmine.github.io/" target="_blank">Jasmine</a> test framework.
 
 ## Discussion
 
@@ -45,7 +45,7 @@ describe 'Calculator', ->
 ### Configuring Jasmine
 
 Before you can run your tests, you must download and configure Jasmine.  This involves:
-1. downloading the latest <a href="http://pivotal.github.com/jasmine/download.html" target="_blank">Jasmine</a> zip file;
+1. downloading the latest <a href="https://github.com/pivotal/jasmine/tree/master/dist" target="_blank">Jasmine</a> zip file;
 2. creating a spec and a spec/jasmine folder in your project;
 3. extracting the downloaded Jasmine files into the spec/jasmine folder; and
 4. creating a test runner.

From 3442e838ec846aff95d1d4da76d5290d5eb27fb2 Mon Sep 17 00:00:00 2001
From: pbihler <bihler@cs.uni-bonn.de>
Date: Mon, 15 Sep 2014 12:45:43 +0200
Subject: [PATCH 071/105] Replaced Songs._titles++ by @constructor._titles

DRY principle applied by removing the reference to the explicit classname within a class itself
---
 .../classes_and_objects/class-methods-and-instance-methods.md   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/classes_and_objects/class-methods-and-instance-methods.md b/chapters/classes_and_objects/class-methods-and-instance-methods.md
index 02b3c30..62d34af 100644
--- a/chapters/classes_and_objects/class-methods-and-instance-methods.md
+++ b/chapters/classes_and_objects/class-methods-and-instance-methods.md
@@ -20,7 +20,7 @@ class Songs
     @_titles
 
   constructor: (@artist, @title) ->
-    Songs._titles++
+    @constructor._titles++     # Refers to <Classname>._titles, in this case Songs.titles
 
 Songs.get_count()
 # => 0

From 29b64e5e700c5564a7ffcd7a0bbcf243982daba5 Mon Sep 17 00:00:00 2001
From: erik <esr081000@utdallas.edu>
Date: Fri, 21 Feb 2014 14:37:19 -0600
Subject: [PATCH 072/105] Grammar tweaks

---
 chapters/ajax/ajax_request_without_jquery.md | 9 ++++-----
 chapters/arrays/define-ranges.md             | 7 +++++--
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/chapters/ajax/ajax_request_without_jquery.md b/chapters/ajax/ajax_request_without_jquery.md
index 917cdfa..8dd9530 100644
--- a/chapters/ajax/ajax_request_without_jquery.md
+++ b/chapters/ajax/ajax_request_without_jquery.md
@@ -23,7 +23,7 @@ Let's set up a simple test HTML page with a button.
 <body>
 	<h1>XMLHttpRequest Tester</h1>
 	<button id="loadDataButton">Load Data</button>
-	
+
 	<script type="text/javascript" src="https://github.com/XMLHttpRequest.js"></script>
 </body>
 </html>
@@ -53,7 +53,7 @@ loadDataFromServer = ->
         console.log 'data message: ', data.message
       else
         console.log 'Error loading data...'
-        
+
   req.open 'GET', 'data.json', false
   req.send()
 
@@ -63,7 +63,7 @@ loadDataButton.addEventListener 'click', loadDataFromServer, false
 
 ## Discussion
 
-In the above code we essentially grab a handle to the button in our HTML (line 16) and add a *click* event listener (line 17).  In our event listener, we define our callback function as loadDataFromServer.
+In the above code we grab a handle to the button in our HTML (line 16) and add a *click* event listener (line 17).  In our event listener, we define our callback function as loadDataFromServer.
 
 We define our loadDataFromServer callback beginning on line 2.
 
@@ -77,7 +77,7 @@ The last thing we need to do is actually make our request.
 
 Line 13 opens a 'GET' request to retrieve the data.json file.
 
-Line 14 sends our request to the server. 
+Line 14 sends our request to the server.
 
 ## Older Browser Support
 
@@ -100,4 +100,3 @@ if (typeof @XMLHttpRequest == "undefined")
 {% endhighlight %}
 
 This code ensures the XMLHttpRequest object is available in the global namespace.
-
diff --git a/chapters/arrays/define-ranges.md b/chapters/arrays/define-ranges.md
index 8296e09..a75a3f4 100644
--- a/chapters/arrays/define-ranges.md
+++ b/chapters/arrays/define-ranges.md
@@ -13,6 +13,7 @@ There are two ways to define a range of array elements in CoffeeScript.
 
 {% highlight coffeescript %}
 
+# inclusive
 myArray = [1..10]
 # => [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
 
@@ -20,6 +21,7 @@ myArray = [1..10]
 
 {% highlight coffeescript %}
 
+# exclusive
 myArray = [1...10]
 # => [ 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
 
@@ -42,6 +44,7 @@ myLargeArray = [10...1]
 
 ## Discussion
 
-Inclusive range always define by '..' operator.
+Inclusive ranges are defined by the '..' operator and include the last value.
+
+Exclusive ranges are defined by '...', and always omit the last value.
 
-Exclusive range define by '...', and always omit the last value. 

From 5b828a05f78e5ce0c5b59a118c79163d88da6f4a Mon Sep 17 00:00:00 2001
From: pbihler <bihler@cs.uni-bonn.de>
Date: Wed, 17 Sep 2014 10:47:38 +0200
Subject: [PATCH 073/105] Instance Variables added

Added section about instance variables (properties), including warning about accidentially adding it to the class prototype
---
 .../class-variables-and-instance-variables.md | 99 +++++++++++++++++++
 .../classes_and_objects/class-variables.md    | 43 --------
 2 files changed, 99 insertions(+), 43 deletions(-)
 create mode 100644 chapters/classes_and_objects/class-variables-and-instance-variables.md
 delete mode 100644 chapters/classes_and_objects/class-variables.md

diff --git a/chapters/classes_and_objects/class-variables-and-instance-variables.md b/chapters/classes_and_objects/class-variables-and-instance-variables.md
new file mode 100644
index 0000000..23acd37
--- /dev/null
+++ b/chapters/classes_and_objects/class-variables-and-instance-variables.md
@@ -0,0 +1,99 @@
+---
+layout: recipe
+title: Class Variables and Instance Variables
+chapter: Classes and Objects
+---
+## Problem
+
+You want to create class variables and instance variables (properties).
+
+## Solution
+
+### Class Variables
+
+{% highlight coffeescript %}
+class Zoo
+  @MAX_ANIMALS: 50
+  MAX_ZOOKEEPERS: 3
+  
+  helpfulInfo: =>
+    "Zoos may contain a maximum of #{@constructor.MAX_ANIMALS} animals and #{@MAX_ZOOKEEPERS} zoo keepers."
+
+Zoo.MAX_ANIMALS
+# => 50
+
+Zoo.MAX_ZOOKEEPERS
+# => undefined (it is a prototype member)
+
+Zoo::MAX_ZOOKEEPERS
+# => 3
+
+zoo = new Zoo
+zoo.MAX_ZOOKEEPERS
+# => 3
+zoo.helpfulInfo()
+# => "Zoos may contain a maximum of 50 animals and 3 zoo keepers."
+
+zoo.MAX_ZOOKEEPERS = "smelly"
+zoo.MAX_ANIMALS = "seventeen"
+zoo.helpfulInfo()
+# => "Zoos may contain a maximum of 50 animals and smelly zoo keepers."
+{% endhighlight %}
+
+
+### Instance Variables
+
+You have to define instance variables (i.e. properties) inside a class' method, initialize your defaults in the constructor.
+
+{% highlight coffeescript %}
+class Zoo
+  constructor: ->
+    @animals = [] # Here the instance variable is defined
+    
+  addAnimal: (name) ->
+    @animals.push name
+
+
+zoo = new Zoo()
+zoo.addAnimal 'elephant'
+
+otherZoo = new Zoo()
+otherZoo.addAnimal 'lion'
+
+zoo.animals
+# => ['elephant']
+
+otherZoo.animals
+# => ['lion']
+{% endhighlight %}
+
+#### WARNING!
+*Do not add the variable accidently to the prototype, by defining it outside the constructor* (Even if mentioned [elsewhere](http://arcturo.github.io/library/coffeescript/03_classes.html#content), this does not work as intended, due to the underlying JavaScript prototype concept).
+
+{% highlight coffeescript %}
+class BadZoo
+  animals: []           # Translates to BadZoo.prototype.animals = []; and is thus shared between instances
+    
+  addAnimal: (name) ->
+    @animals.push name  # Works due to the prototype concept of Javascript
+
+
+zoo = new BadZoo()
+zoo.addAnimal 'elephant'
+
+otherZoo = new BadZoo()
+otherZoo.addAnimal 'lion'
+
+zoo.animals
+# => ['elephant','lion'] # Oops...
+
+otherZoo.animals
+# => ['elephant','lion'] # Oops...
+
+BadZoo::animals
+# => ['elephant','lion'] # The value is stored in the prototype
+{% endhighlight %}
+
+## Discussion
+
+Coffeescript will store the values of class variables on the class itself rather than on the prototype it defines. These are useful for defining variables on classes which can't be overwritten by instance attribute variables.
diff --git a/chapters/classes_and_objects/class-variables.md b/chapters/classes_and_objects/class-variables.md
deleted file mode 100644
index 9d403ef..0000000
--- a/chapters/classes_and_objects/class-variables.md
+++ /dev/null
@@ -1,43 +0,0 @@
----
-layout: recipe
-title: Class Variables
-chapter: Classes and Objects
----
-## Problem
-
-You want to create a class variable.
-
-## Solution
-
-{% highlight coffeescript %}
-class Zoo
-  @MAX_ANIMALS: 50
-  MAX_ZOOKEEPERS: 3
-  
-  helpfulInfo: =>
-    "Zoos may contain a maximum of #{@constructor.MAX_ANIMALS} animals and #{@MAX_ZOOKEEPERS} zoo keepers."
-
-Zoo.MAX_ANIMALS
-# => 50
-
-Zoo.MAX_ZOOKEEPERS
-# => undefined (it is a prototype member)
-
-Zoo::MAX_ZOOKEEPERS
-# => 3
-
-zoo = new Zoo
-zoo.MAX_ZOOKEEPERS
-# => 3
-zoo.helpfulInfo()
-# => "Zoos may contain a maximum of 50 animals and 3 zoo keepers."
-
-zoo.MAX_ZOOKEEPERS = "smelly"
-zoo.MAX_ANIMALS = "seventeen"
-zoo.helpfulInfo()
-# => "Zoos may contain a maximum of 50 animals and smelly zoo keepers."
-{% endhighlight %}
-
-## Discussion
-
-Coffeescript will store these values on the class itself rather than on the prototype it defines.  These are useful for defining variables on classes which can't be overwritten by instance attribute variables.

From b128dcc6760da0ea72bc68becd3c19530709796b Mon Sep 17 00:00:00 2001
From: Dave Powers <djpowers@users.noreply.github.com>
Date: Mon, 3 Nov 2014 12:38:13 -0500
Subject: [PATCH 074/105] Correct "OSX" to "OS X"

---
 developers-guide.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/developers-guide.md b/developers-guide.md
index 909847e..9e39f2f 100644
--- a/developers-guide.md
+++ b/developers-guide.md
@@ -9,7 +9,7 @@ _Please help out by updating this page_
 
 ### Operating System
 
-It works on Mac OSX. Probably works without any changes or issues on Linux.
+It works on Mac OS X. Probably works without any changes or issues on Linux.
 A masochist could probably get it working on Windows.
 
 ## Installation

From 77905d7e9fb09436a53c99b923b528c1e5b061a4 Mon Sep 17 00:00:00 2001
From: Alex Johnson <nonsensery@users.noreply.github.com>
Date: Tue, 25 Nov 2014 14:42:49 -0800
Subject: [PATCH 075/105] Add option for con-splat-enating arrays

CoffeeScript allows you to concatenate arrays by splatting them into an array literal. This change adds a section describing that option.
---
 chapters/arrays/concatenating-arrays.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/chapters/arrays/concatenating-arrays.md b/chapters/arrays/concatenating-arrays.md
index df0be98..a023791 100644
--- a/chapters/arrays/concatenating-arrays.md
+++ b/chapters/arrays/concatenating-arrays.md
@@ -56,6 +56,16 @@ array1
 # => [1, 2, 3, 4, 5, 6]
 {% endhighlight %}
 
+A more idiomatic approach is to use the splat operator (`...`) directly in an array literal. This can be used to concatenate any number of arrays.
+
+{% highlight coffeescript %}
+array1 = [1, 2, 3]
+array2 = [4, 5, 6]
+array3 = [array1..., array2...]
+array3
+# => [1, 2, 3, 4, 5, 6]
+{% endhighlight %}
+
 ## Discussion
 
 CoffeeScript lacks a special syntax for joining arrays, but `concat()` and `push()` are standard JavaScript methods.

From cf6af7220a9abc8a65da196b9f95d911d6221ddb Mon Sep 17 00:00:00 2001
From: Alex Johnson <nonsensery@users.noreply.github.com>
Date: Tue, 25 Nov 2014 14:45:03 -0800
Subject: [PATCH 076/105] Add myself to the authors list

I hope that's not too presumptuous for such a small change.
---
 authors.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/authors.md b/authors.md
index 70bea43..fe612ef 100644
--- a/authors.md
+++ b/authors.md
@@ -23,6 +23,7 @@ The following people are totally rad and awesome because they have contributed r
 * [Anton Rissanen](http://github.com/antris) *hello@anton.fi*
 * Calum Robertson *http://github.com/randusr836*
 * Jake Burkhead *https://github.com/jlburkhead*
+* [Alex Johnson](https://github.com/nonsensery)
 * ...You! What are you waiting for? Check out the [contributing](/contributing) section and get cracking!
 
 # Developers

From ba8b054d85bcaaeb31df8c1fc3c179e329cb94d8 Mon Sep 17 00:00:00 2001
From: neatcoding <johny@toster.org>
Date: Thu, 4 Dec 2014 15:25:57 +0100
Subject: [PATCH 077/105] additional idea of creating .repeat for String

---
 chapters/strings/repeating.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/chapters/strings/repeating.md b/chapters/strings/repeating.md
index 2df0c3c..78214ab 100644
--- a/chapters/strings/repeating.md
+++ b/chapters/strings/repeating.md
@@ -18,6 +18,15 @@ Array(11).join 'foo'
 # => "foofoofoofoofoofoofoofoofoofoo"
 {% endhighlight %}
 
+## Repeat method for Strings
+
+You could also create a method for this in String prototype. It is as simple as that:
+
+{% highlight coffeescript %}
+# add repeat method for all strings, that returns string repeated n times
+String::repeat = (n) -> Array(n+1).join(this)
+{% endhighlight %}
+
 ## Discussion
 
 JavaScript lacks a string repeat function, as does CoffeeScript. List comprehensions and maps can be pressed into service here, but in the case of a simple string repeat it's easier to simply build an array of n+1 nulls and then glue them together.

From 16debf2cb469b32f5d6723d5cef69229cfe341fb Mon Sep 17 00:00:00 2001
From: Chris Coyne <ccoyne77@gmail.com>
Date: Fri, 5 Dec 2014 11:29:50 -0500
Subject: [PATCH 078/105] fixed broken shuffle for arrays of length 1 or 0

Coffeescript's range evaluator (in this case [a.length-1..1]) produces inappropriate results for Fisher-Yates when the array is length 1 or 0. The unfixed shuffle pushes undefined values onto the the array. A length check is necessary to continue with this style.
---
 chapters/arrays/shuffling-array-elements.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 6e115da..b9054e6 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -18,12 +18,13 @@ the algorithm.
 
 {% highlight coffeescript %}
 shuffle = (a) ->
-  # From the end of the list to the beginning, pick element `i`.
-  for i in [a.length-1..1]
-    # Choose random element `j` to the front of `i` to swap with.
-    j = Math.floor Math.random() * (i + 1)
-    # Swap `j` with `i`, using destructured assignment
-    [a[i], a[j]] = [a[j], a[i]]
+  if a.length >= 2
+    # From the end of the list to the beginning, pick element `i`.
+    for i in [a.length-1..1]
+      # Choose random element `j` to the front of `i` to swap with.
+      j = Math.floor Math.random() * (i + 1)
+      # Swap `j` with `i`, using destructured assignment
+      [a[i], a[j]] = [a[j], a[i]]
   # Return the shuffled array.
   a
 

From fb597b29b7d2e505acc64c260a92ae59787400b8 Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Fri, 5 Dec 2014 13:26:55 -0500
Subject: [PATCH 079/105] Drop a level of indent and clean conditional

---
 chapters/arrays/shuffling-array-elements.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 12fbc16..edc2a33 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -79,12 +79,11 @@ The following code adds the shuffle function to the Array prototype, which means
 you are able to run it on any array you wish, in a much more direct manner.
 
 {% highlight coffeescript %}
-do -> Array::shuffle ?= ->
-  if @length > 1
-    for i in [@length-1..1]
-      j = Math.floor Math.random() * (i + 1)
-      [@[i], @[j]] = [@[j], @[i]]
-  @
+Array::shuffle ?= ->
+  if @length > 1 then for i in [@length-1..1]
+    j = Math.floor Math.random() * (i + 1)
+    [@[i], @[j]] = [@[j], @[i]]
+  this
 
 [1..9].shuffle()
 # => [ 3, 1, 5, 6, 4, 8, 2, 9, 7 ]

From 319ca25965909e6d8b1e20bbafbe0adcf2dac450 Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Fri, 5 Dec 2014 13:29:39 -0500
Subject: [PATCH 080/105] Add Underscore.js footnote

---
 chapters/arrays/shuffling-array-elements.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index edc2a33..9686116 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -97,8 +97,10 @@ objects you don’t own][dontown]; [Extending built-in native objects. Evil or n
 operator (`?=`). That way, we don't overwrite someone else's, or a native browser method.
 
 Also, if you think you'll be using a lot of these utility functions, consider using a
-utility library, like [Lo-dash](http://lodash.com/). They include a lot of nifty 
+utility library, like [Lo-dash](http://lodash.com/)^†. They include a lot of nifty
 features, like maps and forEach, in a cross-browser, lean, high-performance way. 
 
+^† [Underscore](http://underscorejs.org/) is also a good alternative to Lo-dash.
+
 [dontown]: http://www.nczonline.net/blog/2010/03/02/maintainable-javascript-dont-modify-objects-you-down-own/
 [extendevil]: http://perfectionkills.com/extending-built-in-native-objects-evil-or-not/

From 6988fe02bba770fb9af032e92b764369d6baa41c Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Fri, 5 Dec 2014 17:36:08 -0500
Subject: [PATCH 081/105] Clarify shuffle code

Better variable names, Removed silly comments, Expanded explination of
@malgorithms commit 16debf2 in comments
---
 chapters/arrays/shuffling-array-elements.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/chapters/arrays/shuffling-array-elements.md b/chapters/arrays/shuffling-array-elements.md
index 2ecec79..c5f4193 100644
--- a/chapters/arrays/shuffling-array-elements.md
+++ b/chapters/arrays/shuffling-array-elements.md
@@ -17,16 +17,16 @@ at the end of the list. This [Fisher-Yates shuffle Visualization] may help you u
 the algorithm.
 
 {% highlight coffeescript %}
-shuffle = (a) ->
-  if a.length >= 2
-    # From the end of the list to the beginning, pick element `i`.
-    for i in [a.length-1..1]
-      # Choose random element `j` to the front of `i` to swap with.
-      j = Math.floor Math.random() * (i + 1)
-      # Swap `j` with `i`, using destructured assignment
-      [a[i], a[j]] = [a[j], a[i]]
-  # Return the shuffled array.
-  a
+shuffle = (source) ->
+  # Arrays with < 2 elements do not shuffle well. Instead make it a noop.
+  return source unless source.length >= 2
+  # From the end of the list to the beginning, pick element `index`.
+  for index in [source.length-1..1]
+    # Choose random element `randomIndex` to the front of `index` to swap with.
+    randomIndex = Math.floor Math.random() * (index + 1)
+    # Swap `randomIndex` with `index`, using destructured assignment
+    [source[index], source[randomIndex]] = [source[randomIndex], source[index]]
+  source
 
 shuffle([1..9])
 # => [ 3, 1, 5, 6, 4, 8, 2, 9, 7 ]

From 1e21f6c7172841fa1d3dd858b17d70b8580dc7e1 Mon Sep 17 00:00:00 2001
From: "lolmaus (Andrey Mikhaylov)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:26:04 +0300
Subject: [PATCH 082/105] Removed CNAME

---
 CNAME | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 CNAME

diff --git a/CNAME b/CNAME
deleted file mode 100644
index 75d2340..0000000
--- a/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-coffeescriptcookbook.com

From 93554ef04e0f8d1111476fccc28183d5c0700648 Mon Sep 17 00:00:00 2001
From: "lolmaus (Andrey Mikhaylov)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:26:48 +0300
Subject: [PATCH 083/105] Added IntelliJ IDEA / Webstorm files to .gitignore

---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index 587c487..3ae9f09 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,7 @@ _site
 *.swo
 
 .DS_Store
+
+# IntelliJ IDEA / WebStorm
+/.idea/
+/*.iml
\ No newline at end of file

From ebfed068b38686f06b43b78a07f9f57666a7e596 Mon Sep 17 00:00:00 2001
From: "lolmaus (Andrey Mikhaylov)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:32:01 +0300
Subject: [PATCH 084/105] Added {{ site.baseurl }} to all links

---
 _config.yml                                   |  1 +
 _layouts/chapter.html                         | 24 +++++++++----------
 _layouts/default.html                         | 24 +++++++++----------
 _layouts/recipe.html                          | 24 +++++++++----------
 authors-guide.md                              |  8 +++----
 authors.md                                    |  6 ++---
 chapters/ajax/index.html                      |  2 +-
 chapters/arrays/index.html                    |  2 +-
 chapters/arrays/list-comprehensions.md        |  4 ++--
 chapters/arrays/mapping-arrays.md             |  4 ++--
 chapters/classes_and_objects/index.html       |  2 +-
 chapters/databases/index.html                 |  2 +-
 chapters/dates_and_times/index.html           |  2 +-
 chapters/design_patterns/adapter.md           |  2 +-
 chapters/design_patterns/index.html           |  2 +-
 chapters/functions/index.html                 |  2 +-
 chapters/index.html                           |  4 ++--
 chapters/jquery/ajax.md                       |  2 +-
 chapters/jquery/index.html                    |  2 +-
 chapters/math/constants.md                    |  2 +-
 chapters/math/generating-random-numbers.md    |  2 +-
 chapters/math/index.html                      |  2 +-
 .../working-with-exponents-and-logarithms.md  |  2 +-
 chapters/metaprogramming/index.html           |  2 +-
 chapters/networking/basic-client.md           |  4 ++--
 chapters/networking/basic-server.md           |  4 ++--
 chapters/networking/bi-directional-client.md  |  4 ++--
 chapters/networking/bi-directional-server.md  |  4 ++--
 chapters/networking/index.html                |  2 +-
 chapters/regular_expressions/index.html       |  2 +-
 chapters/strings/capitalizing-words.md        |  2 +-
 chapters/strings/index.html                   |  2 +-
 chapters/syntax/index.html                    |  2 +-
 chapters/testing/index.html                   |  2 +-
 contributing.md                               |  8 +++----
 designers-guide.md                            |  2 +-
 index.html                                    |  2 +-
 license.md                                    |  2 +-
 38 files changed, 86 insertions(+), 85 deletions(-)

diff --git a/_config.yml b/_config.yml
index fef8911..6214b0c 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,3 +1,4 @@
+baseurl: ''
 safe: true
 pygments: true
 lsi: false
diff --git a/_layouts/chapter.html b/_layouts/chapter.html
index 2bfe664..3023ec9 100644
--- a/_layouts/chapter.html
+++ b/_layouts/chapter.html
@@ -23,15 +23,15 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width">
     <title>CoffeeScript Cookbook &raquo; {{ page.title }}</title>
-    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/images/favicon.ico">
-    <link rel="stylesheet" href="https://github.com/css/style.css" type="text/css">
+    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/favicon.ico">
+    <link rel="stylesheet" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/css/style.css" type="text/css">
   </head>
   <body>
 
     <section class="container">
 
       <header class="header">
-        <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
+        <h1><a class="" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
       </header>
 
       <section class="content">
@@ -42,8 +42,8 @@ <h2>{{ page.title }}</h2>
         </article>
 
         <footer class="footer content-block">
-          <p>Don't see the recipe you want? Add it yourself by reading the <a href="https://github.com/contributing">Contributor's Guide</a>, or request it by adding it to <a href="https://github.com/wanted-recipes">Wanted Recipes</a>.</p>
-          <a href="https://github.com/license"><img src="https://github.com/images/cc_by_badge.png" /></a>
+          <p>Don't see the recipe you want? Add it yourself by reading the <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing">Contributor's Guide</a>, or request it by adding it to <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/wanted-recipes">Wanted Recipes</a>.</p>
+          <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><img src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/cc_by_badge.png" /></a>
         </footer>
 
       </section>
@@ -54,7 +54,7 @@ <h2>{{ page.title }}</h2>
 
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
-          <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
+          <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
           <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
@@ -62,9 +62,9 @@ <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScrip
       <section class="sidebar-block">
         <nav class="navigation pages-nav">
           <ul class="plain-list inline-list">
-            <li><a class="nav-link" href="https://github.com/contributing"><span class="entypo">6</span>Contribute</a></li>
-            <li><a class="nav-link" href="https://github.com/authors"><span class="entypo">,</span>Authors</a></li>
-            <li><a class="nav-link" href="https://github.com/license"><span class="entypo">&copy;</span>License</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing"><span class="entypo">6</span>Contribute</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/authors"><span class="entypo">,</span>Authors</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><span class="entypo">&copy;</span>License</a></li>
           </ul>
         </nav>
       </section>
@@ -76,12 +76,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
                 {% for site_page in site.pages %}
                   {% if site_page.url contains url %}
                     {% unless site_page.url == indexurl %}
-                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -93,7 +93,7 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
-    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+    <script type="text/javascript" src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/js/scripts.js"></script>
 
  </body>
 </html>
diff --git a/_layouts/default.html b/_layouts/default.html
index b45615d..9d8fe47 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -23,15 +23,15 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width">
     <title>CoffeeScript Cookbook &raquo; {{ page.title }}</title>
-    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/images/favicon.ico">
-    <link rel="stylesheet" href="https://github.com/css/style.css" type="text/css">
+    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/favicon.ico">
+    <link rel="stylesheet" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/css/style.css" type="text/css">
   </head>
   <body>
 
     <section class="container">
 
       <header class="header">
-        <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
+        <h1><a class="" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
       </header>
 
       <section class="content">
@@ -39,8 +39,8 @@ <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title
         <article class="content-block">{{ content }}</article>
 
         <footer class="footer content-block">
-          <p>Don't see a recipe you want? See an entire missing chapter? Add it yourself by reading the <a href="https://github.com/contributing">Contributor's Guide</a>, or request it by adding it to <a href="https://github.com/wanted-recipes">Wanted Recipes</a>.</p>
-          <a href="https://github.com/license"><img src="https://github.com/images/cc_by_badge.png" /></a>
+          <p>Don't see a recipe you want? See an entire missing chapter? Add it yourself by reading the <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing">Contributor's Guide</a>, or request it by adding it to <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/wanted-recipes">Wanted Recipes</a>.</p>
+          <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><img src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/cc_by_badge.png" /></a>
         </footer>
 
       </section>
@@ -51,7 +51,7 @@ <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title
 
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
-          <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
+          <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
           <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
@@ -59,9 +59,9 @@ <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScrip
       <section class="sidebar-block">
         <nav class="navigation pages-nav">
           <ul class="plain-list inline-list">
-            <li><a class="nav-link" href="https://github.com/contributing"><span class="entypo">6</span>Contribute</a></li>
-            <li><a class="nav-link" href="https://github.com/authors"><span class="entypo">,</span>Authors</a></li>
-            <li><a class="nav-link" href="https://github.com/license"><span class="entypo">&copy;</span>License</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing"><span class="entypo">6</span>Contribute</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/authors"><span class="entypo">,</span>Authors</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><span class="entypo">&copy;</span>License</a></li>
           </ul>
         </nav>
       </section>
@@ -73,12 +73,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
                 {% for site_page in site.pages %}
                   {% if site_page.url contains url %}
                     {% unless site_page.url == indexurl %}
-                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -90,7 +90,7 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
-    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+    <script type="text/javascript" src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/js/scripts.js"></script>
 
  </body>
 </html>
diff --git a/_layouts/recipe.html b/_layouts/recipe.html
index fd6e969..215830d 100644
--- a/_layouts/recipe.html
+++ b/_layouts/recipe.html
@@ -23,15 +23,15 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width">
     <title>CoffeeScript Cookbook &raquo; {{ page.title }}</title>
-    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/images/favicon.ico">
-    <link rel="stylesheet" href="https://github.com/css/style.css" type="text/css">
+    <link type="image/x-icon" rel="shortcut icon" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/favicon.ico">
+    <link rel="stylesheet" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/css/style.css" type="text/css">
   </head>
   <body>
 
     <section class="container">
 
       <header class="header">
-        <h1><a class="" href="https://github.com/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
+        <h1><a class="" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span><span class="title ir">CoffeeScript Cookbook</span></a></h1>
       </header>
 
       <section class="content">
@@ -42,8 +42,8 @@ <h1>{{ page.title }}</h1>
         </article>
 
         <footer class="footer">
-          <p>Is this recipe wrong, incomplete, or non idiomatic? Help fix it by reading the <a href="https://github.com/contributing">Contributor's Guide</a>!</p>
-          <a href="https://github.com/license"><img src="https://github.com/images/cc_by_badge.png" /></a>
+          <p>Is this recipe wrong, incomplete, or non idiomatic? Help fix it by reading the <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing">Contributor's Guide</a>!</p>
+          <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><img src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/images/cc_by_badge.png" /></a>
         </footer>
       </section>
 
@@ -53,7 +53,7 @@ <h1>{{ page.title }}</h1>
 
       <section class="sidebar-block block-short">
         <nav class="navigation pages-nav home-nav">
-          <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
+          <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;</span>CoffeeScript Cookbook</a></h6>
           <small class="thin dimmed">(last updated {{ site.time | date: "%d %B, %Y" }})</small>
         </nav>
       </section>
@@ -61,9 +61,9 @@ <h6><a class="nav-link" href="https://github.com/"><span class="entypo">&oacute;</span>CoffeeScrip
       <section class="sidebar-block">
         <nav class="navigation pages-nav">
           <ul class="plain-list inline-list">
-            <li><a class="nav-link" href="https://github.com/contributing"><span class="entypo">6</span>Contribute</a></li>
-            <li><a class="nav-link" href="https://github.com/authors"><span class="entypo">,</span>Authors</a></li>
-            <li><a class="nav-link" href="https://github.com/license"><span class="entypo">&copy;</span>License</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing"><span class="entypo">6</span>Contribute</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/authors"><span class="entypo">,</span>Authors</a></li>
+            <li><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/license"><span class="entypo">&copy;</span>License</a></li>
           </ul>
         </nav>
       </section>
@@ -75,12 +75,12 @@ <h5 class="sidebar-title">Chapters Index</h5>
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
-              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
+              <div class="sidebar-subtitle{% if page.url == indexurl %} page-active{% endif %}"><strong><a class="chapter-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20url%20%7D%7D">{{ chapter }}</a></strong></div>
               <ul class="pseudo-list recipes-list">
                 {% for site_page in site.pages %}
                   {% if site_page.url contains url %}
                     {% unless site_page.url == indexurl %}
-                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
+                      <li class="list-item recipe{% if page.url == site_page.url %} page-active{% endif %}"><a class="recipe-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20site_page.url%20|%20replace:'.html', '' }}">{{ site_page.title }}</a></li>
                     {% endunless %}
                   {% endif %}
                 {% endfor %}
@@ -92,7 +92,7 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
     </aside>
 
-    <script type="text/javascript" src="https://github.com/js/scripts.js"></script>
+    <script type="text/javascript" src="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/js/scripts.js"></script>
 
  </body>
 </html>
diff --git a/authors-guide.md b/authors-guide.md
index 54c1b26..2504368 100644
--- a/authors-guide.md
+++ b/authors-guide.md
@@ -6,7 +6,7 @@ title: Author's Guide
 
 ## tl;dr: Look at Other Recipes, and Blend In
 
-Look at the source of other recipe pages and follow that page structure. Start with the [Developer's Guide](/developers-guide) to get a test version of the cookbook up and running on your machine, and get to work!
+Look at the source of other recipe pages and follow that page structure. Start with the [Developer's Guide]({{ site.baseurl }}/developers-guide) to get a test version of the cookbook up and running on your machine, and get to work!
 
 ## General Guidelines
 
@@ -26,7 +26,7 @@ A typical cookbook page will have three sections (four if you count the title):
 
 ## Copyright Issues
 
-Do not post code that is copyrighted by another user, unless you have permission to use that code AND to relicense that code under the [CC BY 3.0](/license) license. If you DO have permission and the author would like credit, please add them to the [authors](/authors) page.
+Do not post code that is copyrighted by another user, unless you have permission to use that code AND to relicense that code under the [CC BY 3.0]({{ site.baseurl }}/license) license. If you DO have permission and the author would like credit, please add them to the [authors]({{ site.baseurl }}/authors) page.
 
 Also, just a stylistic note, please do not yank code directly from [http://coffeescript.org/](http://coffeescript.org/) and post it with little or no discussion. The CoffeeScript Cookbook is not affiliated with them. We think they're awesome and want them to like us, too! Make sure that anything taken from [http://coffeescript.org/](http://coffeescript.org/) is permissible use and that it stands alone as a valid recipe. If the recipe is too terse, consider adding more examples and discussion.
 
@@ -99,7 +99,7 @@ When in doubt about what output to show, try evaluating your snippet in the coff
 
 ## How to Add a Recipe
 
-Create a new markdown page (or copy the [Recipe Template](/recipe-template). The filename should be about the problem, e.g. `finding-last-day-of-the-month.md` or `reversing-arrays.md`. In your file, start with the following template:
+Create a new markdown page (or copy the [Recipe Template]({{ site.baseurl }}/recipe-template). The filename should be about the problem, e.g. `finding-last-day-of-the-month.md` or `reversing-arrays.md`. In your file, start with the following template:
 
 {% highlight text %}
 ---
@@ -175,7 +175,7 @@ See the "Weird Recipe" note above. Do real people in the real world ever hit the
 
 ## I Have A Problem/Solution, But It's Basically Just JavaScript. Should I Add It?
 
-Yes! CoffeeScript compiles to JavaScript, and that means that some of its functionality comes straight from JavaScript. (For example, see [Reversing Arrays](/chapters/arrays/reversing-arrays).) But if you're programming in CoffeeScript and you need to reverse an array, this Cookbook should stand ready to tell you it's available to you in CoffeeScript -- even if it's just a straight call into a JavaScript library.
+Yes! CoffeeScript compiles to JavaScript, and that means that some of its functionality comes straight from JavaScript. (For example, see [Reversing Arrays]({{ site.baseurl }}/chapters/arrays/reversing-arrays).) But if you're programming in CoffeeScript and you need to reverse an array, this Cookbook should stand ready to tell you it's available to you in CoffeeScript -- even if it's just a straight call into a JavaScript library.
 
 ## I Found a Typo. Is That Enough of a Fix? Does That Count?
 
diff --git a/authors.md b/authors.md
index fe612ef..3b3b236 100644
--- a/authors.md
+++ b/authors.md
@@ -24,7 +24,7 @@ The following people are totally rad and awesome because they have contributed r
 * Calum Robertson *http://github.com/randusr836*
 * Jake Burkhead *https://github.com/jlburkhead*
 * [Alex Johnson](https://github.com/nonsensery)
-* ...You! What are you waiting for? Check out the [contributing](/contributing) section and get cracking!
+* ...You! What are you waiting for? Check out the [contributing]({{ site.baseurl }}/contributing) section and get cracking!
 
 # Developers
 
@@ -34,11 +34,11 @@ The following people are totally rad and awesome because they have contributed r
 * Mike Moore *mike@blowmage.com*
 * Peter Hellberg *peter@c7.se*
 * Jamie Gaskins *jgaskins@gmail.com*
-* ...You! What are you waiting for? Check out the [contributing](/contributing) section and get cracking!
+* ...You! What are you waiting for? Check out the [contributing]({{ site.baseurl }}/contributing) section and get cracking!
 
 # Designers
 
 The following people are astonishingly rad and awesome because they did great design for the site!
 
 * [Amsul](http://github.com/amsul) reach@amsul.ca
-* ...You! Check out the [contributing](/contributing) section and get cracking!
+* ...You! Check out the [contributing]({{ site.baseurl }}/contributing) section and get cracking!
diff --git a/chapters/ajax/index.html b/chapters/ajax/index.html
index 5ca402b..0dfcd24 100644
--- a/chapters/ajax/index.html
+++ b/chapters/ajax/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/arrays/index.html b/chapters/arrays/index.html
index 80b9b41..906700a 100644
--- a/chapters/arrays/index.html
+++ b/chapters/arrays/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/arrays/list-comprehensions.md b/chapters/arrays/list-comprehensions.md
index 68e7c88..3ab2700 100644
--- a/chapters/arrays/list-comprehensions.md
+++ b/chapters/arrays/list-comprehensions.md
@@ -9,7 +9,7 @@ You have an array of objects and want to map them to another array, similar to P
 
 ## Solution
 
-Use a list comprehension, but don't forget about [mapping arrays](/chapters/arrays/mapping-arrays).
+Use a list comprehension, but don't forget about [mapping arrays]({{ site.baseurl }}/chapters/arrays/mapping-arrays).
 
 {% highlight coffeescript %}
 electric_mayhem = [ { name: "Doctor Teeth", instrument: "piano" },
@@ -25,4 +25,4 @@ names = (muppet.name for muppet in electric_mayhem)
 
 ## Discussion
 
-Because CoffeeScript directly support list comprehensions, they work pretty much as advertised wherever you would use one in Python. For simple mappings, list comprehensions are much more readable. For complicated transformations or for chained mappings, [mapping arrays](/chapters/arrays/mapping-arrays) might be more elegant.
+Because CoffeeScript directly support list comprehensions, they work pretty much as advertised wherever you would use one in Python. For simple mappings, list comprehensions are much more readable. For complicated transformations or for chained mappings, [mapping arrays]({{ site.baseurl }}/chapters/arrays/mapping-arrays) might be more elegant.
diff --git a/chapters/arrays/mapping-arrays.md b/chapters/arrays/mapping-arrays.md
index 6a54964..1be0e65 100644
--- a/chapters/arrays/mapping-arrays.md
+++ b/chapters/arrays/mapping-arrays.md
@@ -9,7 +9,7 @@ You have an array of objects and want to map them to another array, similar to R
 
 ## Solution
 
-Use map() with an anonymous function, but don't forget about <a href="https://github.com/chapters/arrays/list-comprehensions">list comprehensions</a>.
+Use map() with an anonymous function, but don't forget about <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/chapters/arrays/list-comprehensions">list comprehensions</a>.
 
 {% highlight coffeescript %}
 electric_mayhem = [ { name: "Doctor Teeth", instrument: "piano" },
@@ -27,4 +27,4 @@ names = electric_mayhem.map (muppet) -> muppet.name
 
 Because CoffeeScript has clean support for anonymous functions, mapping an array in CoffeeScript is nearly as easy as it is in Ruby.
 
-Maps are are good way to handle complicated transforms and chained mappings in CoffeeScript. If your transformation is as simple as the one above, however, it may read more cleanly as a <a href="https://github.com/chapters/arrays/list-comprehensions">list comprehension</a>.
+Maps are are good way to handle complicated transforms and chained mappings in CoffeeScript. If your transformation is as simple as the one above, however, it may read more cleanly as a <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/chapters/arrays/list-comprehensions">list comprehension</a>.
diff --git a/chapters/classes_and_objects/index.html b/chapters/classes_and_objects/index.html
index 082c0a3..013fd47 100644
--- a/chapters/classes_and_objects/index.html
+++ b/chapters/classes_and_objects/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/databases/index.html b/chapters/databases/index.html
index 6100569..abf1318 100644
--- a/chapters/databases/index.html
+++ b/chapters/databases/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/dates_and_times/index.html b/chapters/dates_and_times/index.html
index 969aee4..3009762 100644
--- a/chapters/dates_and_times/index.html
+++ b/chapters/dates_and_times/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/design_patterns/adapter.md b/chapters/design_patterns/adapter.md
index bcf4544..e82d19b 100644
--- a/chapters/design_patterns/adapter.md
+++ b/chapters/design_patterns/adapter.md
@@ -10,7 +10,7 @@ Luckily, you remembered you've brought your power adapter with you.
 It will connect your power cord socket on one side and wall socket on the other side, allowing for communication between them.
 
 The same situation may arise in code, when 2 (or more) instances (of classes, modules, etc.) want to talk to each other, but whose communication protocol (e.i. the language they use to communicate) is different from each other.
-In such a situation, the [Adapter Pattern](//en.wikipedia.org/wiki/Adapter_pattern) comes in handy. It will do the translation, from one side to the other.
+In such a situation, the [Adapter Pattern]({{ site.baseurl }}//en.wikipedia.org/wiki/Adapter_pattern) comes in handy. It will do the translation, from one side to the other.
 
 ## Solution
 
diff --git a/chapters/design_patterns/index.html b/chapters/design_patterns/index.html
index e488a5d..a548aad 100644
--- a/chapters/design_patterns/index.html
+++ b/chapters/design_patterns/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/functions/index.html b/chapters/functions/index.html
index be9a60a..eb3b4e9 100644
--- a/chapters/functions/index.html
+++ b/chapters/functions/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/index.html b/chapters/index.html
index 9e2f0e9..28abe74 100644
--- a/chapters/index.html
+++ b/chapters/index.html
@@ -28,12 +28,12 @@ <h5 class="sidebar-title">Chapters</h5>
       {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
       {% capture indexurl %}{{ url }}/index.html{% endcapture %}
       <li class="chapter">
-        <h4><a class="chapter-title" href="https://github.com/%7B%7B%20url%20%7D%7D">{{ chapter }}</a></h4>
+        <h4><a class="chapter-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20url%20%7D%7D">{{ chapter }}</a></h4>
         <ul class="pseudo-list recipes-list">
           {% for page in site.pages %}
             {% if page.url contains url %}
               {% unless page.url == indexurl %}
-                <li class="list-item recipe"><a class="recipe-title" href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+                <li class="list-item recipe"><a class="recipe-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
               {% endunless %}
             {% endif %}
           {% endfor %}
diff --git a/chapters/jquery/ajax.md b/chapters/jquery/ajax.md
index 97d0769..54d89a5 100644
--- a/chapters/jquery/ajax.md
+++ b/chapters/jquery/ajax.md
@@ -43,4 +43,4 @@ jQuery 1.5 and later have added a new, supplemental API for handling different c
 
 ## Discussion
 
-The jQuery and $ variables can be used interchangeably. See also [Callback bindings](/chapters/jquery/callback-bindings-jquery).
+The jQuery and $ variables can be used interchangeably. See also [Callback bindings]({{ site.baseurl }}/chapters/jquery/callback-bindings-jquery).
diff --git a/chapters/jquery/index.html b/chapters/jquery/index.html
index 278cdbe..770dd77 100644
--- a/chapters/jquery/index.html
+++ b/chapters/jquery/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/math/constants.md b/chapters/math/constants.md
index 989012a..d3d25c7 100644
--- a/chapters/math/constants.md
+++ b/chapters/math/constants.md
@@ -45,4 +45,4 @@ Math.LOG10E
 
 ## Discussion
 
-For another example of how a math constant is used in a real world problem, refer to the [Converting Radians and Degrees](/chapters/math/radians-degrees) section of this Math chapter.
+For another example of how a math constant is used in a real world problem, refer to the [Converting Radians and Degrees]({{ site.baseurl }}/chapters/math/radians-degrees) section of this Math chapter.
diff --git a/chapters/math/generating-random-numbers.md b/chapters/math/generating-random-numbers.md
index e795652..e1b3a44 100644
--- a/chapters/math/generating-random-numbers.md
+++ b/chapters/math/generating-random-numbers.md
@@ -36,6 +36,6 @@ range = Math.random() * (max - min) + min
 
 This is a straight lift from JavaScript.
 
-Note that JavaScript's Math.random() does not allow you to seed the random number generator to force certain values. See [Generating Predictable Random Numbers](/chapters/math/generating-predictable-random-numbers) for that.
+Note that JavaScript's Math.random() does not allow you to seed the random number generator to force certain values. See [Generating Predictable Random Numbers]({{ site.baseurl }}/chapters/math/generating-predictable-random-numbers) for that.
 
 To generate a number from 0 up to (but not including) n, multiply by n. To generate a number from 1 to n (inclusive), multiply by n and add 1.
diff --git a/chapters/math/index.html b/chapters/math/index.html
index 5ad24b7..32eafac 100644
--- a/chapters/math/index.html
+++ b/chapters/math/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/math/working-with-exponents-and-logarithms.md b/chapters/math/working-with-exponents-and-logarithms.md
index c8e7c49..13aedaf 100644
--- a/chapters/math/working-with-exponents-and-logarithms.md
+++ b/chapters/math/working-with-exponents-and-logarithms.md
@@ -34,4 +34,4 @@ Math.log(100) / Math.log(10)
 
 ## Discussion
 
-For more information on the Math object see the documentation on the [Mozilla Developer Network](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math). Also refer to [Math Constants](/chapters/math/constants) for discussion of the various constants in the Math object.
+For more information on the Math object see the documentation on the [Mozilla Developer Network](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math). Also refer to [Math Constants]({{ site.baseurl }}/chapters/math/constants) for discussion of the various constants in the Math object.
diff --git a/chapters/metaprogramming/index.html b/chapters/metaprogramming/index.html
index 7287ee9..4a53a21 100644
--- a/chapters/metaprogramming/index.html
+++ b/chapters/metaprogramming/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/networking/basic-client.md b/chapters/networking/basic-client.md
index 64b3452..e9556db 100644
--- a/chapters/networking/basic-client.md
+++ b/chapters/networking/basic-client.md
@@ -31,7 +31,7 @@ connection.on 'data', (data) ->
 
 ### Example Usage
 
-Accessing the [Basic Server](/chapters/networking/basic-server):
+Accessing the [Basic Server]({{ site.baseurl }}/chapters/networking/basic-server):
 
 {% highlight console %}
 $ coffee basic-client.coffee
@@ -43,7 +43,7 @@ Received: Hello, World!
 
 The most important work takes place in the _connection.on 'data'_ handler, where the client receives its response from the server and would most likely arrange for responses to it.
 
-See also the [Basic Server](/chapters/networking/basic-server), [Bi-Directional Client](/chapters/networking/bi-directional-client), and [Bi-Directional Server](/chapters/networking/bi-directional-server) recipes.
+See also the [Basic Server]({{ site.baseurl }}/chapters/networking/basic-server), [Bi-Directional Client]({{ site.baseurl }}/chapters/networking/bi-directional-client), and [Bi-Directional Server]({{ site.baseurl }}/chapters/networking/bi-directional-server) recipes.
 
 ### Exercises
 
diff --git a/chapters/networking/basic-server.md b/chapters/networking/basic-server.md
index 9dd55c9..90bb381 100644
--- a/chapters/networking/basic-server.md
+++ b/chapters/networking/basic-server.md
@@ -30,7 +30,7 @@ server.listen port, domain
 
 ### Example Usage
 
-Accessed by the [Basic Client](/chapters/networking/basic-client):
+Accessed by the [Basic Client]({{ site.baseurl }}/chapters/networking/basic-client):
 
 {% highlight console %}
 $ coffee basic-server.coffee
@@ -44,7 +44,7 @@ Received connection from 127.0.0.1
 
 The function passed to @net.createServer@ receives the new socket provided for each new connection to a client.  This basic server simply socializes with its visitors but a hard-working server would pass this socket along to a dedicated handler and then return to the task of waiting for the next client.
 
-See also the [Basic Client](/chapters/networking/basic-client), [Bi-Directional Server](/chapters/networking/bi-directional-server), and [Bi-Directional Client](/chapters/networking/bi-directional-client) recipes.
+See also the [Basic Client]({{ site.baseurl }}/chapters/networking/basic-client), [Bi-Directional Server]({{ site.baseurl }}/chapters/networking/bi-directional-server), and [Bi-Directional Client]({{ site.baseurl }}/chapters/networking/bi-directional-client) recipes.
 
 ### Exercises
 
diff --git a/chapters/networking/bi-directional-client.md b/chapters/networking/bi-directional-client.md
index b7e020e..99953d7 100644
--- a/chapters/networking/bi-directional-client.md
+++ b/chapters/networking/bi-directional-client.md
@@ -41,7 +41,7 @@ connection.on 'end', (data) ->
 
 ### Example Usage
 
-Accessing the [Bi-Directional Server](/chapters/networking/bi-directional-server):
+Accessing the [Bi-Directional Server]({{ site.baseurl }}/chapters/networking/bi-directional-server):
 
 {% highlight console %}
 $ coffee bi-directional-client.coffee
@@ -60,7 +60,7 @@ Connection closed
 
 This particular example initiates contact with the server and starts the conversation in the @connection.on 'connect'@ handler.  The bulk of the work in a real client, however, will lie in the @connection.on 'data'@ handler, which processes output from the server.  The @ping@  function only recurses in order to illustrate continuous communication with the server and can be removed from a real client.
 
-See also the [Bi-Directional Server](/chapters/networking/bi-directional-server), [Basic Client](/chapters/networking/basic-client), and [Basic Server](/chapters/networking/basic-server) recipes.
+See also the [Bi-Directional Server]({{ site.baseurl }}/chapters/networking/bi-directional-server), [Basic Client]({{ site.baseurl }}/chapters/networking/basic-client), and [Basic Server]({{ site.baseurl }}/chapters/networking/basic-server) recipes.
 
 ### Exercises
 
diff --git a/chapters/networking/bi-directional-server.md b/chapters/networking/bi-directional-server.md
index d187f92..cb1b982 100644
--- a/chapters/networking/bi-directional-server.md
+++ b/chapters/networking/bi-directional-server.md
@@ -33,7 +33,7 @@ server.listen port, domain
 
 ### Example Usage
 
-Accessed by the [Bi-Directional Client](/chapters/networking/bi-directional-client):
+Accessed by the [Bi-Directional Client]({{ site.baseurl }}/chapters/networking/bi-directional-client):
 
 {% highlight console %}
 $ coffee bi-directional-server.coffee
@@ -49,7 +49,7 @@ New connection from 127.0.0.1
 
 The bulk of the work lies in the @socket.on 'data'@ handler, which processes all of the input from the client.  A real server would likely pass the data onto another function to process it and generate any responses so that the original handler.
 
-See also the [Bi-Directional Client](/chapters/networking/bi-directional-client), [Basic Client](/chapters/networking/basic-client), and [Basic Server](/chapters/networking/basic-server) recipes.
+See also the [Bi-Directional Client]({{ site.baseurl }}/chapters/networking/bi-directional-client), [Basic Client]({{ site.baseurl }}/chapters/networking/basic-client), and [Basic Server]({{ site.baseurl }}/chapters/networking/basic-server) recipes.
 
 ### Exercises
 
diff --git a/chapters/networking/index.html b/chapters/networking/index.html
index 5cc875e..27de60d 100644
--- a/chapters/networking/index.html
+++ b/chapters/networking/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/regular_expressions/index.html b/chapters/regular_expressions/index.html
index bc841bc..4af6fec 100644
--- a/chapters/regular_expressions/index.html
+++ b/chapters/regular_expressions/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/strings/capitalizing-words.md b/chapters/strings/capitalizing-words.md
index 17854d6..28ac74d 100644
--- a/chapters/strings/capitalizing-words.md
+++ b/chapters/strings/capitalizing-words.md
@@ -25,7 +25,7 @@ Or do the same thing using a list comprehension:
 
 ## Discussion
 
-Split, map, join is a common scripting pattern dating back to Perl. This function may benefit from being placed directly onto the String class by [Extending Classes](/chapters/objects/extending-classes).
+Split, map, join is a common scripting pattern dating back to Perl. This function may benefit from being placed directly onto the String class by [Extending Classes]({{ site.baseurl }}/chapters/objects/extending-classes).
 
 Be aware that two wrinkles can appear in the split, map, join pattern. The first is that the split text works best when it is constant. If the source string has multiple spaces in it, the split will need to take this into account to prevent getting extra, empty words. One way to do this is with a regular expression to split on runs of whitespace instead of a single space:
 
diff --git a/chapters/strings/index.html b/chapters/strings/index.html
index 50a3d9f..b74efe3 100644
--- a/chapters/strings/index.html
+++ b/chapters/strings/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/syntax/index.html b/chapters/syntax/index.html
index deb6165..03ab758 100644
--- a/chapters/syntax/index.html
+++ b/chapters/syntax/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/chapters/testing/index.html b/chapters/testing/index.html
index a838b6f..228a39f 100644
--- a/chapters/testing/index.html
+++ b/chapters/testing/index.html
@@ -11,7 +11,7 @@
 {% for page in site.pages %}
   {% if page.url contains url %}
     {% unless page.url == indexurl %}
-  <li><a href="https://github.com/%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
+  <li><a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20page.url%20|%20replace:'.html', '' }}">{{ page.title }}</a></li>
     {% endunless %}
   {% endif %}
 {% endfor %}
diff --git a/contributing.md b/contributing.md
index e51cdee..f1f14a7 100644
--- a/contributing.md
+++ b/contributing.md
@@ -15,16 +15,16 @@ Here's the Contribution Recipe:
 
 ## Wanted Recipes
 
-Want to help, but don't know where to start? Want a recipe, but don't know how to write it? Check out the [Wanted Recipes](/wanted-recipes) page!
+Want to help, but don't know where to start? Want a recipe, but don't know how to write it? Check out the [Wanted Recipes]({{ site.baseurl }}/wanted-recipes) page!
 
 ## Authors
 
-Write recipes! Fork the repository, author some pages, and send us a pull request. For more information read the [Author's Guide](/authors-guide).
+Write recipes! Fork the repository, author some pages, and send us a pull request. For more information read the [Author's Guide]({{ site.baseurl }}/authors-guide).
 
 ## Developers
 
-Improve the code! Fork the repository, extend or improve the site coded, and send a pull request. For more information read the [Developer's Guide](/developers-guide).
+Improve the code! Fork the repository, extend or improve the site coded, and send a pull request. For more information read the [Developer's Guide]({{ site.baseurl }}/developers-guide).
 
 ## Designers
 
-Make this site look pretty! Fork the repository, extend, improve or update the design, and send a pull request. For more information read the [Designer's Guide](/designers-guide).
+Make this site look pretty! Fork the repository, extend, improve or update the design, and send a pull request. For more information read the [Designer's Guide]({{ site.baseurl }}/designers-guide).
diff --git a/designers-guide.md b/designers-guide.md
index 3a510a0..df6381c 100644
--- a/designers-guide.md
+++ b/designers-guide.md
@@ -5,7 +5,7 @@ title: Designer's Guide
 
 # Designer's Guide
 
-Start with the [Developer's Guide](/developers-guide) to get a test version of the cookbook up and running on your machine, and get started!
+Start with the [Developer's Guide]({{ site.baseurl }}/developers-guide) to get a test version of the cookbook up and running on your machine, and get started!
 
 If you have been waiting for your chance to literally _write the designer's guide_ for a website that is also a cookbook about CoffeeScript...
 
diff --git a/index.html b/index.html
index 98947f9..cd3f572 100644
--- a/index.html
+++ b/index.html
@@ -5,7 +5,7 @@
 
 
 <h2>Welcome to the CoffeeScript Cookbook!</h2>
-<p>CoffeeScript recipes for the community <em>by</em> the community. Head over to the <a href="https://github.com/contributing">Contribute</a> page and see what you can do to help out!</p>
+<p>CoffeeScript recipes for the community <em>by</em> the community. Head over to the <a href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/contributing">Contribute</a> page and see what you can do to help out!</p>
 
 
 
diff --git a/license.md b/license.md
index f4a9905..ae1a2ee 100644
--- a/license.md
+++ b/license.md
@@ -5,4 +5,4 @@ title: License
 
 coffeescriptcookbook.com is licensed under the [Creative Commons Attribution 3.0 Unported (CC BY 3.0)](http://creativecommons.org/licenses/by/3.0/) license. By submitting information to this site you agree to grant this license to all users of the site, and that your editing of the authors page constitutes satisfactory attribution.
 
-[LICENSE](/LICENSE-CC-BY)
+[LICENSE]({{ site.baseurl }}/LICENSE-CC-BY)

From cedf5fa4dbce6b8ff8046b7f7715dfcc5c27aa86 Mon Sep 17 00:00:00 2001
From: "lolmaus (Andrey Mikhaylov)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:38:26 +0300
Subject: [PATCH 085/105] Updated the hostname in links
 coffeescriptcookbook.com -> coffeescript-cookbook.github.io

---
 README.md  | 14 +++++++-------
 license.md |  2 +-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 7378cd1..ce574db 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@ We want you to write recipes and make the site better!
 Contributing
 -----------
 
-You can find details about contributing [on the site](http://coffeescriptcookbook.com/contributing). For now here is a simple formula:
+You can find details about contributing [on the site](http://coffeescript-cookbook.github.io/contributing). For now here is a simple formula:
 
 1. Fork the repository at [GitHub](http://github.com/coffeescript-cookbook/coffeescript-cookbook.github.com)
 2. Do awesomeness!
@@ -16,11 +16,11 @@ You can find details about contributing [on the site](http://coffeescriptcookboo
 
 Here are some relevant links from the site.
 
-* [Contributing](http://coffeescriptcookbook.com/contributing)
-* [Recipe Template](http://coffeescriptcookbook.com/recipe-template)
-* [Author's Guide](http://coffeescriptcookbook.com/authors-guide)
-* [Developer's Guide](http://coffeescriptcookbook.com/developers-guide)
-* [Designer's Guide](http://coffeescriptcookbook.com/designers-guide)
+* [Contributing](http://coffeescript-cookbook.github.io/contributing)
+* [Recipe Template](http://coffeescript-cookbook.github.io/recipe-template)
+* [Author's Guide](http://coffeescript-cookbook.github.io/authors-guide)
+* [Developer's Guide](http://coffeescript-cookbook.github.io/developers-guide)
+* [Designer's Guide](http://coffeescript-cookbook.github.io/designers-guide)
 
 Jekyll
 ------
@@ -34,4 +34,4 @@ CoffeeScript Cookbook is currently implemented as a jekyll site. Jekyll is aweso
 License
 -------
 
-This site and all contributions are [licensed](http://coffeescriptcookbook.com/LICENSE-CC-BY) under the Creative Commons Attribution 3.0 Unported (CC BY 3.0) license. By submitting information to this site you agree to grant this license to all users of the site, and that your editing of the authors page constitutes satisfactory attribution.
\ No newline at end of file
+This site and all contributions are [licensed](http://coffeescript-cookbook.github.io/LICENSE-CC-BY) under the Creative Commons Attribution 3.0 Unported (CC BY 3.0) license. By submitting information to this site you agree to grant this license to all users of the site, and that your editing of the authors page constitutes satisfactory attribution.
\ No newline at end of file
diff --git a/license.md b/license.md
index ae1a2ee..2c473db 100644
--- a/license.md
+++ b/license.md
@@ -3,6 +3,6 @@ layout: default
 title: License
 ---
 
-coffeescriptcookbook.com is licensed under the [Creative Commons Attribution 3.0 Unported (CC BY 3.0)](http://creativecommons.org/licenses/by/3.0/) license. By submitting information to this site you agree to grant this license to all users of the site, and that your editing of the authors page constitutes satisfactory attribution.
+coffeescript-cookbook.github.io is licensed under the [Creative Commons Attribution 3.0 Unported (CC BY 3.0)](http://creativecommons.org/licenses/by/3.0/) license. By submitting information to this site you agree to grant this license to all users of the site, and that your editing of the authors page constitutes satisfactory attribution.
 
 [LICENSE]({{ site.baseurl }}/LICENSE-CC-BY)

From 6ca1c38ce68b8606379f9c189e31aace9afc2c26 Mon Sep 17 00:00:00 2001
From: "Andrey Mikhaylov (lolmaus)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:43:38 +0300
Subject: [PATCH 086/105] Attempting to flush DNS redirect

---
 CNAME | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 CNAME

diff --git a/CNAME b/CNAME
new file mode 100644
index 0000000..35b04c6
--- /dev/null
+++ b/CNAME
@@ -0,0 +1 @@
+google.com

From abea624c622c4212ff593dc3cf846ff1ca360d6e Mon Sep 17 00:00:00 2001
From: "Andrey Mikhaylov (lolmaus)" <lolmaus@gmail.com>
Date: Fri, 9 Jan 2015 19:44:30 +0300
Subject: [PATCH 087/105] Attempting to flush DNS redirect, part 2

---
 CNAME | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 CNAME

diff --git a/CNAME b/CNAME
deleted file mode 100644
index 35b04c6..0000000
--- a/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-google.com

From 349ba7b718e57c67e41ae425b4636621b96fd485 Mon Sep 17 00:00:00 2001
From: Chase Pursley <chasepursley@gmail.com>
Date: Mon, 20 Apr 2015 09:52:10 -0400
Subject: [PATCH 088/105] Add square array brackets

---
 chapters/arrays/reducing-arrays.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/chapters/arrays/reducing-arrays.md b/chapters/arrays/reducing-arrays.md
index 37d5e98..6b52690 100644
--- a/chapters/arrays/reducing-arrays.md
+++ b/chapters/arrays/reducing-arrays.md
@@ -24,10 +24,11 @@ You can simply use Array's `reduce()` and `reduceRight()` methods along with an
 Or it may be something more complex such as aggregating elements from a list into a combined object.
 
 {% highlight coffeescript %}
-people =
+people = [
     { name: 'alec', age: 10 }
     { name: 'bert', age: 16 }
     { name: 'chad', age: 17 }
+]
 
 people.reduce (x, y) ->
     x[y.name]= y.age

From 3a21a0d4a801b61d21eb431ea005e3dab4415482 Mon Sep 17 00:00:00 2001
From: Chase Pursley <chasepursley@gmail.com>
Date: Wed, 22 Apr 2015 19:20:16 -0400
Subject: [PATCH 089/105] Grammar

---
 chapters/dates_and_times/days-between-two-dates.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/dates_and_times/days-between-two-dates.md b/chapters/dates_and_times/days-between-two-dates.md
index 11f6894..5b923cb 100644
--- a/chapters/dates_and_times/days-between-two-dates.md
+++ b/chapters/dates_and_times/days-between-two-dates.md
@@ -5,7 +5,7 @@ chapter: Dates and Times
 ---
 ## Problem
 
-You need to find how much seconds minutes, hours, days, months or years has passed between two dates.
+You need to find how many seconds minutes, hours, days, months or years has passed between two dates.
 
 ## Solution
 

From fa3720bc1b2274608900255bfb8e2ff4d75be419 Mon Sep 17 00:00:00 2001
From: Chase Pursley <chasepursley@gmail.com>
Date: Wed, 22 Apr 2015 19:21:41 -0400
Subject: [PATCH 090/105] Grammar 2

---
 chapters/dates_and_times/days-between-two-dates.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/chapters/dates_and_times/days-between-two-dates.md b/chapters/dates_and_times/days-between-two-dates.md
index 5b923cb..def2cc3 100644
--- a/chapters/dates_and_times/days-between-two-dates.md
+++ b/chapters/dates_and_times/days-between-two-dates.md
@@ -22,12 +22,10 @@ days_passed = Math.round((d2.getTime() - d1.getTime()) / DAY)
 
 ## Discussion
 
-Using milliseconds makes the life easier to avoid overflow mistakes with Dates. So we first calculate how much milliseconds has a day.
-Then, given two distinct dates, just get the difference in milliseconds between two dates and then divide by how much milliseconds has a
-day. It will get you the days between two distinct dates.
+Using milliseconds makes the life easier to avoid overflow mistakes with Dates. So we first calculate how many milliseconds are in a day.
+Then, given two distinct dates, just get the difference in milliseconds between two dates and then divide by how many milliseconds are in a day. It will return the days between two distinct dates.
 
-If you'd like to calculate the hours between two date objects, you can do that just by dividing the difference in milliseconds by the
-conversion of milliseconds to hours. The same goes for minutes and seconds.
+If you'd like to calculate the hours between two date objects, you can do that just by dividing the difference in milliseconds by the conversion of milliseconds to hours. The same goes for minutes and seconds.
 
 {% highlight coffeescript %}
 HOUR = 1000 * 60 * 60

From 23520f84a33023d13426ae43699e97caa17eec4d Mon Sep 17 00:00:00 2001
From: Chase Pursley <chasepursley@gmail.com>
Date: Sat, 25 Apr 2015 12:23:17 -0400
Subject: [PATCH 091/105] Add comma

---
 chapters/dates_and_times/days-between-two-dates.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/dates_and_times/days-between-two-dates.md b/chapters/dates_and_times/days-between-two-dates.md
index def2cc3..d70408f 100644
--- a/chapters/dates_and_times/days-between-two-dates.md
+++ b/chapters/dates_and_times/days-between-two-dates.md
@@ -5,7 +5,7 @@ chapter: Dates and Times
 ---
 ## Problem
 
-You need to find how many seconds minutes, hours, days, months or years has passed between two dates.
+You need to find how many seconds, minutes, hours, days, months or years has passed between two dates.
 
 ## Solution
 

From 8942bab7bd05eafb1f0afb626b5f73cde9cfe02c Mon Sep 17 00:00:00 2001
From: Chase Pursley <chasepursley@gmail.com>
Date: Sat, 25 Apr 2015 12:24:48 -0400
Subject: [PATCH 092/105] A few other grammar changes

---
 chapters/dates_and_times/days-between-two-dates.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/chapters/dates_and_times/days-between-two-dates.md b/chapters/dates_and_times/days-between-two-dates.md
index d70408f..b6a94e9 100644
--- a/chapters/dates_and_times/days-between-two-dates.md
+++ b/chapters/dates_and_times/days-between-two-dates.md
@@ -5,11 +5,11 @@ chapter: Dates and Times
 ---
 ## Problem
 
-You need to find how many seconds, minutes, hours, days, months or years has passed between two dates.
+You need to find how many seconds, minutes, hours, days, months or years have passed between two dates.
 
 ## Solution
 
-Use JavaScript's Date function  getTime(). Which provides how much time in milliseconds has passed since 01/01/1970:
+Use JavaScript's Date function  getTime(). Which provides how much time in milliseconds have passed since 01/01/1970:
 
 {% highlight coffeescript %}
 DAY = 1000 * 60 * 60  * 24
@@ -23,9 +23,9 @@ days_passed = Math.round((d2.getTime() - d1.getTime()) / DAY)
 ## Discussion
 
 Using milliseconds makes the life easier to avoid overflow mistakes with Dates. So we first calculate how many milliseconds are in a day.
-Then, given two distinct dates, just get the difference in milliseconds between two dates and then divide by how many milliseconds are in a day. It will return the days between two distinct dates.
+Then, given two distinct dates, get the difference in milliseconds between two dates and then divide by how many milliseconds are in a day. It will return the days between two distinct dates.
 
-If you'd like to calculate the hours between two date objects, you can do that just by dividing the difference in milliseconds by the conversion of milliseconds to hours. The same goes for minutes and seconds.
+If you'd like to calculate the hours between two date objects, you can do that by dividing the difference in milliseconds by the conversion of milliseconds to hours. The same goes for minutes and seconds.
 
 {% highlight coffeescript %}
 HOUR = 1000 * 60 * 60

From 5738c9f8f958864ab6db67d83f3f14130e09c2fe Mon Sep 17 00:00:00 2001
From: Joel Byrnes <byrnes.joel@gmail.com>
Date: Wed, 27 May 2015 12:44:37 -0400
Subject: [PATCH 093/105] Fixed a typo

---
 chapters/design_patterns/interpreter.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/design_patterns/interpreter.md b/chapters/design_patterns/interpreter.md
index 0f6ba9d..654c324 100644
--- a/chapters/design_patterns/interpreter.md
+++ b/chapters/design_patterns/interpreter.md
@@ -140,4 +140,4 @@ send toasted ham turkey sandwich to 'Rachel' # => "Rachel requested a toasted, w
 send toasted turkey ham swiss sandwich to 'Matt' # => "Matt requested a toasted, white bread sandwich with swiss, ham and turkey"
 {% endhighlight %}
 
-This example allows for layers of functions by how it returns the modified object so that outer functions can modify it in turn.  By borrowing a very and the particle _to_, the example lends natural grammar to the construction and ends up reading like an actual sentence when used correctly.  This way, both your CoffeeScript skills and your existing language skills can help catch code problems.
+This example allows for layers of functions by how it returns the modified object so that outer functions can modify it in turn.  By borrowing a verb and the particle _to_, the example lends natural grammar to the construction and ends up reading like an actual sentence when used correctly.  This way, both your CoffeeScript skills and your existing language skills can help catch code problems.

From 3e08e7c20af41f8e9a94661be2f86d32bd459d58 Mon Sep 17 00:00:00 2001
From: Joel Byrnes <byrnes.joel@gmail.com>
Date: Wed, 27 May 2015 15:52:34 -0400
Subject: [PATCH 094/105] Change "the particle _to_" to read: "the preposition
 _to"

---
 chapters/design_patterns/interpreter.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/design_patterns/interpreter.md b/chapters/design_patterns/interpreter.md
index 654c324..e3fa133 100644
--- a/chapters/design_patterns/interpreter.md
+++ b/chapters/design_patterns/interpreter.md
@@ -140,4 +140,4 @@ send toasted ham turkey sandwich to 'Rachel' # => "Rachel requested a toasted, w
 send toasted turkey ham swiss sandwich to 'Matt' # => "Matt requested a toasted, white bread sandwich with swiss, ham and turkey"
 {% endhighlight %}
 
-This example allows for layers of functions by how it returns the modified object so that outer functions can modify it in turn.  By borrowing a verb and the particle _to_, the example lends natural grammar to the construction and ends up reading like an actual sentence when used correctly.  This way, both your CoffeeScript skills and your existing language skills can help catch code problems.
+This example allows for layers of functions by how it returns the modified object so that outer functions can modify it in turn.  By borrowing a verb and the preposition _to_, the example lends natural grammar to the construction and ends up reading like an actual sentence when used correctly.  This way, both your CoffeeScript skills and your existing language skills can help catch code problems.

From a0f55a3cfebb4e8ce83033f6756df05fa93615d8 Mon Sep 17 00:00:00 2001
From: Sami Pussinen <me@samipussinen.com>
Date: Thu, 10 Dec 2015 08:47:18 +0200
Subject: [PATCH 095/105] Fixed a minor typo in the chaining page.

---
 chapters/classes_and_objects/chaining.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/chapters/classes_and_objects/chaining.md b/chapters/classes_and_objects/chaining.md
index be19212..d8d099e 100644
--- a/chapters/classes_and_objects/chaining.md
+++ b/chapters/classes_and_objects/chaining.md
@@ -66,9 +66,9 @@ class TeaCup
 			cream: false
 		addChainedAttributeAccessor(this, 'properties', attr) for attr of @properties
 
-earlgrey = new TeaCup().size('small').type('Earl Grey').sugar('false')
+earlgrey = new TeaCup().size('small').type('Earl Grey').sugar(false)
 
-earlgrey.properties # => { size: 'small', type: 'Earl Grey', sugar: false }
+earlgrey.properties # => { size: 'small', type: 'Earl Grey', sugar: false, cream: false }
 
 earlgrey.sugar true
 

From 7fa9559f4af96f68e00d956c60267d6fa49b5dac Mon Sep 17 00:00:00 2001
From: Sami Pussinen <me@samipussinen.com>
Date: Thu, 10 Dec 2015 08:48:17 +0200
Subject: [PATCH 096/105] Added myself to the authors page.

---
 authors.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/authors.md b/authors.md
index 3b3b236..3d152cd 100644
--- a/authors.md
+++ b/authors.md
@@ -34,6 +34,7 @@ The following people are totally rad and awesome because they have contributed r
 * Mike Moore *mike@blowmage.com*
 * Peter Hellberg *peter@c7.se*
 * Jamie Gaskins *jgaskins@gmail.com*
+* Sami Pussinen *me@samipussinen.com*
 * ...You! What are you waiting for? Check out the [contributing]({{ site.baseurl }}/contributing) section and get cracking!
 
 # Designers

From 202bdfdd61c26f34120eae12699b25532fcd0f59 Mon Sep 17 00:00:00 2001
From: Data-Meister <fred.fisher.dev@gmail.com>
Date: Thu, 21 Jan 2016 18:01:17 +0000
Subject: [PATCH 097/105] Add a recipe to count occurrences of a given string
 within a message

---
 chapters/strings/finding-substrings.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/chapters/strings/finding-substrings.md b/chapters/strings/finding-substrings.md
index a33af8c..5a070d2 100644
--- a/chapters/strings/finding-substrings.md
+++ b/chapters/strings/finding-substrings.md
@@ -24,8 +24,14 @@ message.indexOf "This", 5
 message.lastIndexOf "This"
 # => 49
 
-{% endhighlight %}
 
-## Discussion
+# Count occurrences of a given string
+
+    substrCount = (str, subStr) ->
+      re = new RegExp( subStr ,"g" )
+      ( str.match(re) or [] ).length
 
-Still need recipe to count occurrences of a given string within a message.
+substrCount message, " a "
+# => 3
+
+{% endhighlight %}

From d6da838694e611a73822cdaf667ec5b9530260f3 Mon Sep 17 00:00:00 2001
From: Data-Meister <fred.fisher.dev@gmail.com>
Date: Thu, 28 Jan 2016 17:56:24 +0000
Subject: [PATCH 098/105] Faster, simpler way to count occurrences of a given
 string

---
 chapters/strings/finding-substrings.md | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/chapters/strings/finding-substrings.md b/chapters/strings/finding-substrings.md
index 5a070d2..ee81e89 100644
--- a/chapters/strings/finding-substrings.md
+++ b/chapters/strings/finding-substrings.md
@@ -24,14 +24,8 @@ message.indexOf "This", 5
 message.lastIndexOf "This"
 # => 49
 
-
 # Count occurrences of a given string
-
-    substrCount = (str, subStr) ->
-      re = new RegExp( subStr ,"g" )
-      ( str.match(re) or [] ).length
-
-substrCount message, " a "
+message.split(" a ").length - 1
 # => 3
 
 {% endhighlight %}

From fdb756a70280aad027f8213677d067282eb6007c Mon Sep 17 00:00:00 2001
From: Data-Meister <fred.fisher.dev@gmail.com>
Date: Thu, 28 Jan 2016 21:52:23 +0000
Subject: [PATCH 099/105] Add new chapter: replacing sub-strings

---
 chapters/strings/replacing-sub-strings.md | 29 +++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 chapters/strings/replacing-sub-strings.md

diff --git a/chapters/strings/replacing-sub-strings.md b/chapters/strings/replacing-sub-strings.md
new file mode 100644
index 0000000..add9945
--- /dev/null
+++ b/chapters/strings/replacing-sub-strings.md
@@ -0,0 +1,29 @@
+---
+layout: recipe
+title: Replacing Sub-Strings Within a String
+chapter: Strings
+---
+## Problem
+
+You want to replace a sub-string with a new sub-string.
+
+## Solution
+
+Split the string using the sub-string you want to remove as a delimiter. Then re-join using the new sub-string as the delimiter.
+
+{% highlight coffeescript %}
+"Orange is the new Black".split("Orange").join("Pink")
+# => "Pink is the new Black"
+
+"I am so sad. I cannot believe how sad I am today!".split("sad").join("happy")
+# => "I am so happy. I cannot believe how happy I am today!"
+
+"I am not a crook.".split("not ").join("")
+# => "I am a crook."
+{% endhighlight %}
+
+## Discussion
+
+You can also use regexes. If you're matching an exact string, this way is simpler and 10x faster.
+ 
+If you use regexes, remember that you must escape certain characters. 

From 9b10230f4b5c76486b201b90802fa0141e4001e3 Mon Sep 17 00:00:00 2001
From: tijwelch <tijwelch@gmail.com>
Date: Tue, 6 Sep 2016 06:12:18 -0500
Subject: [PATCH 100/105] Fix typo in syntax chapter

---
 chapters/syntax/code_reuse_on_client_and_server.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/chapters/syntax/code_reuse_on_client_and_server.md b/chapters/syntax/code_reuse_on_client_and_server.md
index f7a1aca..92e706b 100644
--- a/chapters/syntax/code_reuse_on_client_and_server.md
+++ b/chapters/syntax/code_reuse_on_client_and_server.md
@@ -57,7 +57,7 @@ undefined
 
 {% endhighlight %}
 
-In our web page, we can include our module using by including it as a script.
+In our web page, we can include our module by including it as a script.
 
 {% highlight html %}
 

From e3fbf9fa83336611571500c42361fb7b4194ef7f Mon Sep 17 00:00:00 2001
From: Mike Moore <mike@blowmage.com>
Date: Wed, 11 Jan 2017 09:09:34 -0700
Subject: [PATCH 101/105] Update development dependencies

The versions of gems specified in the Gemfile.lock require ruby 1.9.3.
Update them to the latest and greatest gems.
---
 Gemfile      |   4 +-
 Gemfile.lock | 178 +++++++++++++++++++++++++++++++++++++--------------
 2 files changed, 131 insertions(+), 51 deletions(-)

diff --git a/Gemfile b/Gemfile
index b4d66ba..b700031 100644
--- a/Gemfile
+++ b/Gemfile
@@ -4,6 +4,6 @@ group :development do
   gem "github-pages"
   gem "tzinfo-data"
 
-  gem "foreman",  "~> 0.63"
-  gem "serve",    "~> 1.5"
+  gem "foreman"
+  gem "serve"
 end
diff --git a/Gemfile.lock b/Gemfile.lock
index d8185b6..682c357 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -2,56 +2,125 @@ GEM
   remote: https://rubygems.org/
   specs:
     RedCloth (4.2.9)
-    activesupport (3.2.14)
+    activesupport (3.2.22.5)
       i18n (~> 0.6, >= 0.6.4)
       multi_json (~> 1.0)
-    classifier (1.3.3)
-      fast-stemmer (>= 1.0.0)
+    addressable (2.4.0)
+    blankslate (2.1.2.4)
+    classifier-reborn (2.1.0)
+      fast-stemmer (~> 1.0)
+    coffee-script (2.4.1)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.12.2)
     colorator (0.1)
-    commander (4.1.5)
-      highline (~> 1.6.11)
-    directory_watcher (1.4.1)
-    dotenv (0.8.0)
+    ethon (0.10.1)
+      ffi (>= 1.3.0)
+    execjs (2.7.0)
+    faraday (0.10.1)
+      multipart-post (>= 1.2, < 3)
     fast-stemmer (1.0.2)
-    foreman (0.63.0)
-      dotenv (>= 0.7)
-      thor (>= 0.13.6)
-    github-pages (1)
+    ffi (1.9.14)
+    foreman (0.82.0)
+      thor (~> 0.19.1)
+    gemoji (2.1.0)
+    github-pages (39)
       RedCloth (= 4.2.9)
-      jekyll (= 1.1.2)
-      kramdown (= 1.0.2)
-      liquid (= 2.5.1)
-      maruku (= 0.6.1)
-      rdiscount (= 1.6.8)
-      redcarpet (= 2.2.2)
-    highline (1.6.19)
-    i18n (0.6.5)
-    jekyll (1.1.2)
-      classifier (~> 1.3)
+      github-pages-health-check (~> 0.2)
+      jekyll (= 2.4.0)
+      jekyll-coffeescript (= 1.0.1)
+      jekyll-feed (= 0.3.1)
+      jekyll-mentions (= 0.2.1)
+      jekyll-redirect-from (= 0.8.0)
+      jekyll-sass-converter (= 1.3.0)
+      jekyll-sitemap (= 0.8.1)
+      jemoji (= 0.5.0)
+      kramdown (= 1.5.0)
+      liquid (= 2.6.2)
+      maruku (= 0.7.0)
+      mercenary (~> 0.3)
+      pygments.rb (= 0.6.3)
+      rdiscount (= 2.1.7)
+      redcarpet (= 3.3.2)
+      terminal-table (~> 1.4)
+    github-pages-health-check (0.3.2)
+      net-dns (~> 0.6)
+      public_suffix (~> 1.4)
+      typhoeus (~> 0.7)
+    html-pipeline (1.9.0)
+      activesupport (>= 2)
+      nokogiri (~> 1.4)
+    i18n (0.7.0)
+    jekyll (2.4.0)
+      classifier-reborn (~> 2.0)
       colorator (~> 0.1)
-      commander (~> 4.1.3)
-      directory_watcher (~> 1.4.1)
-      kramdown (~> 1.0.2)
-      liquid (~> 2.5.1)
-      maruku (~> 0.5)
-      pygments.rb (~> 0.5.0)
-      redcarpet (~> 2.2.2)
-      safe_yaml (~> 0.7.0)
-    kramdown (1.0.2)
-    liquid (2.5.1)
-    maruku (0.6.1)
-      syntax (>= 1.0.0)
-    multi_json (1.7.9)
-    posix-spawn (0.3.6)
-    pygments.rb (0.5.2)
+      jekyll-coffeescript (~> 1.0)
+      jekyll-gist (~> 1.0)
+      jekyll-paginate (~> 1.0)
+      jekyll-sass-converter (~> 1.0)
+      jekyll-watch (~> 1.1)
+      kramdown (~> 1.3)
+      liquid (~> 2.6.1)
+      mercenary (~> 0.3.3)
+      pygments.rb (~> 0.6.0)
+      redcarpet (~> 3.1)
+      safe_yaml (~> 1.0)
+      toml (~> 0.1.0)
+    jekyll-coffeescript (1.0.1)
+      coffee-script (~> 2.2)
+    jekyll-feed (0.3.1)
+    jekyll-gist (1.4.0)
+      octokit (~> 4.2)
+    jekyll-mentions (0.2.1)
+      html-pipeline (~> 1.9.0)
+      jekyll (~> 2.0)
+    jekyll-paginate (1.1.0)
+    jekyll-redirect-from (0.8.0)
+      jekyll (>= 2.0)
+    jekyll-sass-converter (1.3.0)
+      sass (~> 3.2)
+    jekyll-sitemap (0.8.1)
+    jekyll-watch (1.5.0)
+      listen (~> 3.0, < 3.1)
+    jemoji (0.5.0)
+      gemoji (~> 2.0)
+      html-pipeline (~> 1.9)
+      jekyll (>= 2.0)
+    kramdown (1.5.0)
+    liquid (2.6.2)
+    listen (3.0.8)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+    maruku (0.7.0)
+    mercenary (0.3.6)
+    mini_portile2 (2.1.0)
+    multi_json (1.12.1)
+    multipart-post (2.0.0)
+    net-dns (0.8.0)
+    nokogiri (1.7.0.1)
+      mini_portile2 (~> 2.1.0)
+    octokit (4.6.2)
+      sawyer (~> 0.8.0, >= 0.5.3)
+    parslet (1.5.0)
+      blankslate (~> 2.0)
+    posix-spawn (0.3.12)
+    public_suffix (1.5.3)
+    pygments.rb (0.6.3)
       posix-spawn (~> 0.3.6)
-      yajl-ruby (~> 1.1.0)
-    rack (1.5.2)
-    rack-test (0.6.2)
+      yajl-ruby (~> 1.2.0)
+    rack (1.5.5)
+    rack-test (0.6.3)
       rack (>= 1.0)
-    rdiscount (1.6.8)
-    redcarpet (2.2.2)
-    safe_yaml (0.7.1)
+    rb-fsevent (0.9.8)
+    rb-inotify (0.9.7)
+      ffi (>= 0.5.0)
+    rdiscount (2.1.7)
+    redcarpet (3.3.2)
+    safe_yaml (1.0.4)
+    sass (3.4.23)
+    sawyer (0.8.1)
+      addressable (>= 2.3.5, < 2.6)
+      faraday (~> 0.8, < 1.0)
     serve (1.5.2)
       activesupport (~> 3.2.12)
       i18n
@@ -59,19 +128,30 @@ GEM
       rack-test (~> 0.6.2)
       tilt (~> 1.3.3)
       tzinfo
-    syntax (1.0.0)
-    thor (0.18.1)
+    terminal-table (1.7.3)
+      unicode-display_width (~> 1.1.1)
+    thor (0.19.4)
+    thread_safe (0.3.5)
     tilt (1.3.7)
-    tzinfo (1.0.1)
-    tzinfo-data (1.2013.4)
+    toml (0.1.2)
+      parslet (~> 1.5.0)
+    typhoeus (0.8.0)
+      ethon (>= 0.8.0)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    tzinfo-data (1.2016.10)
       tzinfo (>= 1.0.0)
-    yajl-ruby (1.1.0)
+    unicode-display_width (1.1.2)
+    yajl-ruby (1.2.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  foreman (~> 0.63)
+  foreman
   github-pages
-  serve (~> 1.5)
+  serve
   tzinfo-data
+
+BUNDLED WITH
+   1.13.7

From 482af694b205f9213c2c89c1497f9989cd986aaa Mon Sep 17 00:00:00 2001
From: Mike Moore <mike@blowmage.com>
Date: Wed, 11 Jan 2017 09:11:05 -0700
Subject: [PATCH 102/105] Use new Jekyll configuration for code highlighting

This removes the following warning:

Deprecation: The 'pygments' configuration option has been renamed to 'highlighter'.
Please update your config file accordingly. The allowed values are 'rouge', 'pygments' or null.
---
 _config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_config.yml b/_config.yml
index 6214b0c..20fa234 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,6 +1,6 @@
 baseurl: ''
 safe: true
-pygments: true
+highlighter: pygments
 lsi: false
 markdown: redcarpet
 exclude:

From 50515c7deeefe5ac55d390740d0961f953ac9d7f Mon Sep 17 00:00:00 2001
From: Mike Moore <mike@blowmage.com>
Date: Wed, 11 Jan 2017 09:30:37 -0700
Subject: [PATCH 103/105] Replace page data with site data

---
 _data/chapters.yml    | 16 ++++++++++++++++
 _layouts/chapter.html | 22 +---------------------
 _layouts/default.html | 22 +---------------------
 _layouts/recipe.html  | 22 +---------------------
 chapters/index.html   | 20 ++------------------
 5 files changed, 21 insertions(+), 81 deletions(-)
 create mode 100644 _data/chapters.yml

diff --git a/_data/chapters.yml b/_data/chapters.yml
new file mode 100644
index 0000000..9c47918
--- /dev/null
+++ b/_data/chapters.yml
@@ -0,0 +1,16 @@
+---
+- Syntax
+- Classes and Objects
+- Strings
+- Arrays
+- Dates and Times
+- Math
+- Functions
+- Metaprogramming
+- jQuery
+- Ajax
+- Regular Expressions
+- Networking
+- Design Patterns
+- Databases
+- Testing
diff --git a/_layouts/chapter.html b/_layouts/chapter.html
index 3023ec9..3daeeed 100644
--- a/_layouts/chapter.html
+++ b/_layouts/chapter.html
@@ -1,22 +1,3 @@
----
-chapters:
-- Syntax
-- Classes and Objects
-- Strings
-- Arrays
-- Dates and Times
-- Math
-- Functions
-- Metaprogramming
-- jQuery
-- Ajax
-- Regular Expressions
-- Networking
-- Design Patterns
-- Databases
-- Testing
----
-
 <!doctype html>
 <html>
   <head>
@@ -72,7 +53,7 @@ <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;
       <section class="sidebar-block">
         <h5 class="sidebar-title">Chapters Index</h5>
         <ol class="navigation chapters-list">
-          {% for chapter in page.chapters %}
+          {% for chapter in site.data.chapters %}
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
@@ -97,4 +78,3 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
  </body>
 </html>
-
diff --git a/_layouts/default.html b/_layouts/default.html
index 9d8fe47..cbb539a 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -1,22 +1,3 @@
----
-chapters:
-- Syntax
-- Classes and Objects
-- Strings
-- Arrays
-- Dates and Times
-- Math
-- Functions
-- Metaprogramming
-- jQuery
-- Ajax
-- Regular Expressions
-- Networking
-- Design Patterns
-- Databases
-- Testing
----
-
 <!doctype html>
 <html>
   <head>
@@ -69,7 +50,7 @@ <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;
       <section class="sidebar-block">
         <h5 class="sidebar-title">Chapters Index</h5>
         <ol class="navigation chapters-list">
-          {% for chapter in page.chapters %}
+          {% for chapter in site.data.chapters %}
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
@@ -94,4 +75,3 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
  </body>
 </html>
-
diff --git a/_layouts/recipe.html b/_layouts/recipe.html
index 215830d..eb1a03c 100644
--- a/_layouts/recipe.html
+++ b/_layouts/recipe.html
@@ -1,22 +1,3 @@
----
-chapters:
-- Syntax
-- Classes and Objects
-- Strings
-- Arrays
-- Dates and Times
-- Math
-- Functions
-- Metaprogramming
-- jQuery
-- Ajax
-- Regular Expressions
-- Networking
-- Design Patterns
-- Databases
-- Testing
----
-
 <!doctype html>
 <html>
   <head>
@@ -71,7 +52,7 @@ <h6><a class="nav-link" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D/"><span class="entypo">&oacute;
       <section class="sidebar-block">
         <h5 class="sidebar-title">Chapters Index</h5>
         <ol class="navigation chapters-list">
-          {% for chapter in page.chapters %}
+          {% for chapter in site.data.chapters %}
             {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
             {% capture indexurl %}{{ url }}/index.html{% endcapture %}
             <li class="chapter">
@@ -96,4 +77,3 @@ <h5 class="sidebar-title">Chapters Index</h5>
 
  </body>
 </html>
-
diff --git a/chapters/index.html b/chapters/index.html
index 28abe74..51b99cf 100644
--- a/chapters/index.html
+++ b/chapters/index.html
@@ -1,22 +1,6 @@
 ---
 layout: default
 title: Cookbook
-chapters:
-- Syntax
-- Classes and Objects
-- Strings
-- Arrays
-- Dates and Times
-- Math
-- Functions
-- Metaprogramming
-- jQuery
-- Ajax
-- Regular Expressions
-- Networking
-- Design Patterns
-- Databases
-- Testing
 ---
 
 <article class="content-block">
@@ -24,7 +8,7 @@
   <h5 class="sidebar-title">Chapters</h5>
 
   <ol class="navigation chapters-list">
-    {% for chapter in page.chapters %}
+    {% for chapter in site.data.chapters %}
       {% capture url %}/chapters/{{ chapter | replace: ' ', '_' | downcase }}{% endcapture %}
       {% capture indexurl %}{{ url }}/index.html{% endcapture %}
       <li class="chapter">
@@ -42,4 +26,4 @@ <h4><a class="chapter-title" href="https://github.com/%7B%7B%20site.baseurl%20%7D%7D%7B%7B%20url%20%7D%7D">{{ chapter }}</a
     {% endfor %}
   </ol>
 
-</article>
\ No newline at end of file
+</article>

From 685b09b44f3e8fabad856d3329c94e3bc25dd4a9 Mon Sep 17 00:00:00 2001
From: Francisco Ruiz <kikorb@gmail.com>
Date: Fri, 17 Mar 2017 20:51:13 +0100
Subject: [PATCH 104/105] Add more accurate details on CS ?= opperator (#146)

* Update object-literal.md

The example was wrong. It stated that ?= is similar to JS || when the || will affect not only not defined scenario but also any falsy values (values that evaluate as false)

There are way to many differences between the 2:

1. window.var = false;
2. window.var = 0;
3. window.var = '';
4. window.var = [];
5. window.var = null;

window.var ?= 'something'
console.log(window.var) ->
1. false
2. 0
3. ''
4. []
5. 'something'

window.var ||= 'something'
console.log(window.var) ->
1. 'something'
2. 'something'
3. 'something'
4. []
5. 'something'

* Update object-literal.md

* Update object-literal.md
---
 .../classes_and_objects/object-literal.md     | 26 +++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/chapters/classes_and_objects/object-literal.md b/chapters/classes_and_objects/object-literal.md
index 7d9d2f0..602ccf3 100644
--- a/chapters/classes_and_objects/object-literal.md
+++ b/chapters/classes_and_objects/object-literal.md
@@ -20,7 +20,29 @@ window.MY_NAMESPACE ?= {}
 This is equivalent to the following JavaScript:
 
 {% highlight javascript %}
-window.MY_NAMESPACE = window.MY_NAMESPACE || {};
+if(window.MY_NAMESPACE === null || window.MY_NAMESPACE === undefined) {
+  window.MY_NAMESPACE = {};
+}
 {% endhighlight %}
 
-Common JavaScript technique, using object literal to define a namespace. This saves us from clobbering the namespace if it already exists.
+## Problem
+
+You want to make a conditonal assignment if it does not exists or if it is falsy (empty, 0, null, false)
+
+## Solution
+
+Use the Conditional assignment operator
+
+{% highlight coffeescript %}
+window.my_variable ||= {}
+{% endhighlight %}
+
+## Discussion
+
+This is equivalent to the following JavaScript:
+
+{% highlight javascript %}
+window.my_variable = window.my_variable || {};
+{% endhighlight %}
+
+Common JavaScript technique, using conditional assignment to ensure that we have an object that is not falsy

From b152fa0264f7904278d8dbbd48bc5a5b9d0d1d1c Mon Sep 17 00:00:00 2001
From: Devin Weaver <suki@tritarget.org>
Date: Sun, 5 Nov 2017 07:32:48 -0500
Subject: [PATCH 105/105] Add myself to the Developers list

Because I've [contributed fixes to the code base][1] I thought maybe I could be
on the attributions list.

[1]: https://github.com/coffeescript-cookbook/coffeescript-cookbook.github.io/search?q=author%3Asukima&type=Commits
---
 authors.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/authors.md b/authors.md
index 3d152cd..d5181f6 100644
--- a/authors.md
+++ b/authors.md
@@ -35,6 +35,7 @@ The following people are totally rad and awesome because they have contributed r
 * Peter Hellberg *peter@c7.se*
 * Jamie Gaskins *jgaskins@gmail.com*
 * Sami Pussinen *me@samipussinen.com*
+* [Devin Weaver (@sukima)](https://github.com/sukima)
 * ...You! What are you waiting for? Check out the [contributing]({{ site.baseurl }}/contributing) section and get cracking!
 
 # Designers