Browse files

Readme changes

  • Loading branch information...
sathish316 committed Aug 28, 2011
1 parent a18c125 commit b74c9348d2ad41a6ce9ec98cfec639add4bbaaa3
Showing with 8 additions and 10 deletions.
  1. +8 −10 README.markdwon → README
@@ -1,12 +1,12 @@
-= Ruby Metaprogramming Koans
+## Ruby Metaprogramming Koans
Ruby Metaprogramming Koans walk you along the path to enlightenment in order to learn Metaprogramming in Ruby.
It is inspired by the original [Ruby koans]( by Jim Weirich which can be forked here:
Koans teach you a programming language using Tests/TDD.
Metaprogramming koans attempts to teach Ruby metaprogramming using the same philosophy of koans used for programming languages.
-== Metaprogramming examples
+### Metaprogramming examples
The metaprogramming examples used in the koans are derived from the following sources:
@@ -17,7 +17,7 @@
The koans are a starting point and only supplement the above articles/books/videos.
Please use the original source for more enlightenment.
-== The Structure
+### The Structure
The koans are broken out into areas by file, metaclasses are covered in about_metaclasses.rb,
define_method is covered in about_define_method.rb, etc. They are presented in order in the
@@ -26,7 +26,7 @@ path_to_enlightenment.rb file.
Each koan builds up your knowledge of Ruby metaprogramming and builds upon itself. Koans will
have __ or ___ which you need to fill in with the correct answer to progress.
-== Installing Ruby
+### Installing Ruby
The koans require Ruby 1.9.2. To install Ruby:
@@ -37,7 +37,7 @@ $ rvm install ruby-1.9.2
All the koans are in Test::Unit and don't require additional gems
-== The Path To Enlightenment
+### The Path To Enlightenment
To start working your way through the koans, run rake
@@ -53,7 +53,7 @@ metaprogramming_koans$ ruby about_metaclasses.rb
Follow the instructions and keep filling the answers to start your journey towards mastering metaprogramming in Ruby
-== Inspiration
+### Inspiration
[The Little Schemer](
by Daniel Friedman is one of my all time favorite programming books.
@@ -68,7 +68,7 @@ it is an automated testsuite that's asking you questions.
If you're learning Ruby, you should check out the [original koans]( first:
-== Other Resources
+### Other Resources
To get more insight on the Ruby koans way of learning, check out the [EdgeCase Ruby koans](
@@ -77,7 +77,7 @@ Following are some more resources to learn Metaprogramming in Ruby:
2. Ruby Object model and metaprogramming screencasts
3. Metaprogramming Ruby
-== How do i add my own koans?
+### Adding Koans
To add your own koans and contribute to the community:
1. Fork this repo
@@ -88,7 +88,5 @@ To add your own koans and contribute to the community:
6. Execute $rake gen to generate koans/about_foo.rb with all assertions replaced with __
7. Create pull request
-== License
You're free to copy, add, change or distribute the koans here.
The structure of this whole project is forked from Edgecase Ruby koans (

0 comments on commit b74c934

Please sign in to comment.