Break up trails into beginning, intermediate, and advanced levels

* Add Ongoing Reference section where applicable * Remove Advanced section in Code Review * Add 'Why's poignant guide' and 'RubyMonk' to ruby trail Minor: * Add .gitignore file * Capitalize Ruby Library Reference * Use expanded url for code review resource (short url was failing tests)
thoughtbot · May 10, 2013 · 123c44a · 123c44a
1 parent 9c51053
commit 123c44a
Show file tree

Hide file tree

Showing 24 changed files with 221 additions and 179 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,2 @@
+bin/
+.bundle/
diff --git a/trails/code-review.json b/trails/code-review.json
@@ -3,22 +3,19 @@
   "description": "A peer review of source code. It is intended to find and fix mistakes overlooked in the initial development phase, improving both the overall quality of software and the developers' skills.",
   "steps": [
     {
-      "name": "Read about code reviews.",
+      "name": "Beginning Code Review",
       "resources": [
         {
           "title": "Feature branch code reviews",
-          "uri": "http://goo.gl/jIcOv",
+          "uri": "http://smartbear.com/SmartBear/media/pdfs/WP-CC-11-Best-Practices-of-Peer-Code-Review.pdf",
           "id": "7702effa2708d62e70512aefb47d19df37e9c7f0"
         },
         {
           "title": "Best practices of peer code review",
           "uri": "http://goo.gl/A8Boc",
           "id": "962c93403800b355f2e1fef25774988934abf1a5"
         }
-      ]
-    },
-    {
-      "name": "Review someone else's code",
+      ],
       "validations": [
         {
           "title": "Comment on a specific line number.",
@@ -43,7 +40,7 @@
       ]
     },
     {
-      "name": "Have your code reviewed",
+      "name": "Intermediate Code Review",
       "validations": [
         {
           "title": "Create small pull requests, which are easier to review.",

diff --git a/trails/design.json b/trails/design.json
@@ -3,7 +3,7 @@
   "description": "Visually communicate a message or action with text, images, and shapes.",
   "steps": [
     {
-      "name": "First learn design basics: Visual Principles, Grid Systems, Typography and Color",
+      "name": "Beginning Design",
       "resources": [
         {
           "title": "Read 'Visual Grammar' for an introduction to visual principles of design",
@@ -71,7 +71,7 @@
       ]
     },
     {
-      "name": "Dig deeper into each basic design topic",
+      "name": "Intermediate Design",
       "resources": [
         {
           "title": "Visit 'Visual Principles' on Learn to augment your learning on visual principles",
@@ -91,7 +91,7 @@
       ]
     },
     {
-      "name": "Look into specific practices of design",
+      "name": "Ongoing Reference",
       "resources": [
         {
           "title": "Visit 'Web Design' on Learn",

diff --git a/trails/git.json b/trails/git.json
@@ -3,7 +3,7 @@
   "description": "A distributed revision control and source code management system with an emphasis on speed.",
   "steps": [
     {
-      "name": "Learn everyday git",
+      "name": "Beginning Git",
       "resources": [
         {
           "title": "Try Git",
@@ -131,7 +131,7 @@
       ]
     },
     {
-      "name": "Advanced Git",
+      "name": "Ongoing Reference",
       "resources": [
         {
           "title": "git-clone",

diff --git a/trails/grids.json b/trails/grids.json
@@ -6,7 +6,7 @@
   ],
   "steps": [
     {
-      "name": "Critical Learning",
+      "name": "Beginning Grids",
       "resources": [
         {
           "title": "Grid Systems: Principles of Organizing Type",

diff --git a/trails/html-css.json b/trails/html-css.json
@@ -3,7 +3,7 @@
   "description": "HTML is the markup language for displaying web pages and other information that can be displayed in a web browser. CSS is a language used for describing the look and formatting of HTML. Together they form the foundation of the web.",
   "steps": [
     {
-      "name": "First read one or more of these introduction books",
+      "name": "Beginning HTML & CSS",
       "resources": [
         {
           "title": "HTML and CSS: Design and Build Websites",
@@ -22,6 +22,11 @@
           "id": "a723d16963fd6729516393433bbd9b901f489395",
           "publisher": "http://simplebits.com/publications/bulletproof/",
           "ibook": "itms-books://itunes.apple.com/us/book/bulletproof-web-design-improving/id483421070?mt=11"
+        },
+        {
+          "title": "Complete Code Academy Web Fundamentals",
+          "uri": "http://www.codecademy.com/tracks/web",
+          "id": "1d8fbe7bbe0a30ebc78468131b468d0a3e5f95e0"
         }
       ],
       "validations": [
@@ -60,17 +65,7 @@
       ]
     },
     {
-      "name": "Run through the tutorials at Code Academy",
-      "resources": [
-        {
-          "title": "Complete Code Academy Web Fundamentals",
-          "uri": "http://www.codecademy.com/tracks/web",
-          "id": "1d8fbe7bbe0a30ebc78468131b468d0a3e5f95e0"
-        }
-      ]
-    },
-    {
-      "name": "Dig deeper into HTML5",
+      "name": "Intermediate HTML & CSS",
       "resources": [
         {
           "title": "Read Dive into HTML5",
@@ -96,31 +91,13 @@
         {
           "title": "Know all of the new form input types and if used how to safely degrade them to older browsers",
           "id": "ddc0dcd3a995cb4f5cea734841a73af061c4b549"
-        }
-      ]
-    },
-    {
-      "name": "Dig deeper into CSS3",
-      "resources": [
-        {
-          "title": "CSS3 for Web Designers",
-          "uri": "http://www.abookapart.com/products/css3-for-web-designers",
-          "id": "d9d3c1d41c0963ae1de6ae2f041365813d88176e",
-          "ibook": "itms-books://itunes.apple.com/us/book/css3-for-web-designers/id405582149?mt=11"
         },
         {
-          "title": "Refer to CSS3.info",
-          "uri": "http://www.css3.info/",
-          "id": "9d176a97334e9cdba0ff7022f52ae38508dd3ced"
-        }
-      ],
-      "validations": [
-        {
-          "title": "Can apply a box shadow, rounded corners, and text shadow",
+          "title": "Apply a box shadow, rounded corners, and text shadow",
           "id": "716ec582fb914e453001d74b175def2fb9cd112d"
         },
         {
-          "title": "Can use RGBa, HSL, HSLa, and opacity",
+          "title": "Use RGBa, HSL, HSLa, and opacity",
           "id": "a472be29ea68bada79c1255738bd9e06649b9d15"
         },
         {
@@ -142,7 +119,7 @@
       ]
     },
     {
-      "name": "Learn about responsive and mobile first design",
+      "name": "Advanced HTML & CSS",
       "resources": [
         {
           "title": "Read Responsive Web Design the article",
@@ -175,6 +152,11 @@
           "title": "Read Put Your Content In My Pocket",
           "uri": "http://www.alistapart.com/articles/putyourcontentinmypocket/",
           "id": "9e4fcc17fc0678228157914461b08d567c8600f5"
+        },
+        {
+          "title": "Visit Sass on Learn",
+          "uri": "http://learn.thoughtbot.com/sass",
+          "id": "c0b7b53fd59586cf900e803af84c96ab854738be"
         }
       ],
       "validations": [
@@ -207,16 +189,11 @@
           "title": "Refer to the HTML5 Spec",
           "uri": "http://dev.w3.org/html5/spec/single-page.html",
           "id": "3d72ce80d850495ec111602c8b2bf7e628020be8"
-        }
-      ]
-    },
-    {
-      "name": "Learn about Sass",
-      "resources": [
+        },
         {
-          "title": "Visit Sass on Learn",
-          "uri": "http://learn.thoughtbot.com/sass",
-          "id": "c0b7b53fd59586cf900e803af84c96ab854738be"
+          "title": "Refer to CSS3.info",
+          "uri": "http://www.css3.info/",
+          "id": "9d176a97334e9cdba0ff7022f52ae38508dd3ced"
         }
       ]
     }

diff --git a/trails/information-design.json b/trails/information-design.json
@@ -1,9 +1,9 @@
 {
   "name": "Information Design",
-  "description": "The skill and practice of preparing information so people can use it with efficiency and effectiveness.",
+  "description": "The skill and practice of preparing information so people can use it efficiently and effectively.",
   "steps": [
     {
-      "name": "Critical Learning",
+      "name": "Beginning Information Design",
       "resources": [
         {
           "title": "Read Information Dashboard Design",

diff --git a/trails/ios.json b/trails/ios.json
@@ -3,7 +3,7 @@
   "description": "The mobile operating system that runs on the iPhone, iPad, iPod touch, and Apple TV.",
   "steps": [
     {
-      "name": "Critical Learning",
+      "name": "Beginning iOS",
       "resources": [
         {
           "title": "Read Learning Objective-C: A Primer",
@@ -110,7 +110,7 @@
       ]
     },
     {
-      "name": "Ongoing Reference",
+      "name": "Advanced iOS",
       "resources": [
         {
           "title": "Maintain an active ADC account and refer to the official documentation",

diff --git a/trails/javascript.json b/trails/javascript.json
@@ -3,10 +3,10 @@
   "description": "The primary programming language used for client-side in-browser functionality.",
   "steps": [
     {
-      "name": "Understand the fundamentals",
+      "name": "Beginning JavaScript",
       "resources": [
         {
-          "title": "Codecademy",
+          "title": "Complete Codecademy's JavaScript Track",
           "uri": "http://www.codecademy.com/tracks/javascript",
           "id": "e147d44ef6484f358b143f86f2d9b67818356c20"
         }
@@ -51,19 +51,23 @@
         {
           "title": "Iterate over collections.",
           "id": "a89f3f40edd0bf7e9b83c0e3c6d42bce5b22311f"
+        },
+        {
+          "title": "Use Web Inspector to test your ideas.",
+          "id": "ec8398e5dd8e898564f49b54e00951e551fd3734"
         }
       ]
     },
     {
-      "name": "Get a deeper understanding",
+      "name": "Intermediate JavaScript",
       "resources": [
         {
-          "title": "Eloquent JavaScript",
+          "title": "Read Eloquent JavaScript",
           "uri": "http://eloquentjavascript.net/contents.html",
           "id": "503ef2c828c94e73cd41e7f757cb70365416367c"
         },
         {
-          "title": "JavaScript Garden",
+          "title": "Read about common mistakes and subtle bugs, as well as performance issues and bad practices in JavaScript Garden",
           "uri": "http://bonsaiden.github.com/JavaScript-Garden/",
           "id": "3c1384d70bf54b60f59616c9ff23828b55b7c1d1"
         },
@@ -87,26 +91,17 @@
       ]
     },
     {
-      "name": "Understand how to build interactive pages",
+      "name": "Advanced JavaScript",
       "resources": [
         {
-          "title": "JavaScript Web Applications",
+          "title": "Read JavaScript Web Applications",
           "uri": "http://amzn.to/javascript-web-apps",
           "id": "c51812e7b048fc40a36f2c19a6177eec53c6ef12",
           "publisher": "http://shop.oreilly.com/product/0636920018421.do",
           "ibook": "itms-books://itunes.apple.com/us/book/javascript-web-applications/id462427083?mt=11"
-        },
-        {
-          "title": "jQuery API",
-          "uri": "http://api.jquery.com",
-          "id": "47cbf943a5e8e7888cdf0779f1f14323cc621b37"
         }
       ],
       "validations": [
-        {
-          "title": "Use Web Inspector to test your ideas.",
-          "id": "ec8398e5dd8e898564f49b54e00951e551fd3734"
-        },
         {
           "title": "Make HTTP requests.",
           "id": "2826aad79522c6f0275ae1bb8f76e53507371a8a"
@@ -158,19 +153,28 @@
         {
           "title": "Bind a view element to a JavaScript object (usually a model).",
           "id": "19b1659cb283f8a8edd994203909cb7be4993502"
+        },
+        {
+          "title": "Conform to a style guide",
+          "id": "6d98b52811029f423d1e0b452428912d39134f28"
         }
       ]
     },
     {
-      "name": "Conform to a style guide",
+      "name": "Ongoing Reference",
       "resources": [
         {
-          "title": "Google JavaScript Style Guide",
+          "title": "Review the jQuery API",
+          "uri": "http://api.jquery.com",
+          "id": "47cbf943a5e8e7888cdf0779f1f14323cc621b37"
+        },
+        {
+          "title": "Read the Google JavaScript Style Guide",
           "uri": "http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml",
           "id": "c80ce3b2101f6b0f78a281c83f3083d043b13965"
         },
         {
-          "title": "JQuery Core Style Guidelines",
+          "title": "Read the JQuery Core Style Guidelines",
           "uri": "http://docs.jquery.com/JQuery_Core_Style_Guidelines",
           "id": "bf7268b11c62cfa39b70ee66531e037c605393b4"
         }

diff --git a/trails/open-source.json b/trails/open-source.json
@@ -10,7 +10,7 @@
   ],
   "steps": [
     {
-      "name": "Use open source",
+      "name": "Beginning Open Source",
       "resources": [
         {
           "title": "Get a GitHub account",
@@ -69,7 +69,7 @@
       ]
     },
     {
-      "name": "Contribute to open source",
+      "name": "Intermediate Open Source",
       "resources": [
         {
           "title": "Read 8 steps to fixing other people's code",
@@ -134,7 +134,7 @@
       ]
     },
     {
-      "name": "Maintain an open source project",
+      "name": "Advanced Open Source",
       "resources": [
         {
           "title": "Watch How to manage an open source project",

diff --git a/trails/product-design.json b/trails/product-design.json
@@ -3,7 +3,7 @@
   "description": "",
   "steps": [
     {
-      "name": "Critical Learning",
+      "name": "Beginning Product Design",
       "resources": [
         {
           "title": "Read \"The Lean Startup\".",