Skip to content
Browse files

[#7] Apply sections template to Rails trail

* Use relative links in README.
  • Loading branch information...
1 parent 15d2186 commit e48f0967ccbdd84e2266fc86ca9e75cbe5ee49d7 @croaky croaky committed May 6, 2012
Showing with 47 additions and 23 deletions.
  1. +25 −17 README.md
  2. +22 −6 trails/rails.md
View
42 README.md
@@ -3,33 +3,41 @@ Trail map
> How do I learn Ruby on Rails? Vim? Test-Driven Development?
-We run a program, [apprentice.io](http://apprentice.io), that has forced us to formalize our answers to such questions.
+[apprentice.io](http://apprentice.io) has forced us to formalize our answers to
+such questions.
-A few problems make those questions difficult to answer:
+A few problems make those questions difficult to answer. Individuals:
-* Apprentices have different levels of experience.
-* Apprentices have different learning styles.
-* Apprentices' goals change mid-process.
+* have different levels of experience
+* have different learning styles
+* change their goals mid-process
-Hiking, biking, or skiing trails are a good metaphor for the learning process: people start in different places, want to go to different places, and change direction mid-journey.
+A good metaphor for the learning process is a (hiking, biking, or skiing)
+trail map. Individuals:
+
+* start in different places
+* want to go to different places
+* change direction mid-journey
![Trail map](http://media.tumblr.com/tumblr_m2jrde9jXS1qz5x9p.jpg)
-This repository is a collection of trails to help web designers and developers learn some cool tools and techniques.
+This repository contains trails to help designers and developers learn.
Trails
------
-* [Git](https://github.com/thoughtbot/trail-map/blob/master/trails/git.md)
-* [Postgres](https://github.com/thoughtbot/trail-map/blob/master/trails/postgres.md)
-* [Rails](https://github.com/thoughtbot/trail-map/blob/master/trails/rails.md)
-* [Refactoring](https://github.com/thoughtbot/trail-map/blob/master/trails/refactoring.md)
-* [Ruby](https://github.com/thoughtbot/trail-map/blob/master/trails/ruby.md)
-* [Test-Driven Development](https://github.com/thoughtbot/trail-map/blob/master/trails/test-driven-development.md)
-* [Unix](https://github.com/thoughtbot/trail-map//blob/master/trails/unix.md)
-* [Vim](https://github.com/thoughtbot/trail-map//blob/master/trails/vim.md)
-
-To use these tools and techniques, you might want to first set up your laptop with [this script](https://github.com/thoughtbot/laptop) and [these dotfiles](https://github.com/thoughtbot/dotfiles).
+* [Git](/thoughtbot/trail-map/blob/master/trails/git.md)
+* [Postgres](/thoughtbot/trail-map/blob/master/trails/postgres.md)
+* [Rails](/thoughtbot/trail-map/blob/master/trails/rails.md)
+* [Refactoring](/thoughtbot/trail-map/blob/master/trails/refactoring.md)
+* [Ruby](/thoughtbot/trail-map/blob/master/trails/ruby.md)
+* [Test-Driven Development](/thoughtbot/trail-map/blob/master/trails/test-driven-development.md)
+* [Unix](/thoughtbot/trail-map/blob/master/trails/unix.md)
+* [Vim](/thoughtbot/trail-map/blob/master/trails/vim.md)
+
+To use these, you may want to first set up your laptop with
+[this script](https://github.com/thoughtbot/laptop) and
+[these dotfiles](https://github.com/thoughtbot/dotfiles).
Credits
-------
View
28 trails/rails.md
@@ -1,13 +1,29 @@
Rails
=====
+Critical learning
+-----------------
+
* Read [the official guides](http://guides.rubyonrails.org).
-* Refer to [the API documentation](http://api.rubyonrails.org) often.
* Push your code to [Github](http://github.com).
* Deploy to [Heroku](http://heroku.com).
* Watch [Railscasts](http://railscasts.com) that interest you.
-* Review [The Ruby Toolbox](https://www.ruby-toolbox.com) before implementing a feature.
-* If you don't understand an error, [Google](http://google.com) it. You'll probably get an answer.
-* If not, submit to [StackOverflow](http://stackoverflow.com/questions/tagged/ruby-on-rails).
-* Stick to a [style guide](https://github.com/copycopter/style-guide).
-* Ask mentors for [code reviews](http://playbook.thoughtbot.com/working-in-feedback-loops/feature-branch-code-reviews/).
+
+Validation
+----------
+
+You know everyday Rails when you can:
+
+* Create a route, controller, and action.
+* Query the database.
+* Create a form that save records.
+* Associate ActiveRecord objects.
+* Validate ActiveRecord objects.
+* Whitelist ActiveRecord attributes.
+* Interpolate data in a view.
+
+Ongoing reference
+-----------------
+
+* Refer to [the API documentation](http://api.rubyonrails.org).
+* Stick to a [style guide](https://github.com/bbatsov/rails-style-guide).

0 comments on commit e48f096

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