The koans have support for Watchr now, and this is very helpful
as you can focus on editing and not on re-running rake over and
over. However, a user new to Ruby will not even know what Watchr
is (I'd not used it before! I was using Guard) so they might miss
this choice.
There are some other minor edits for style and consistency. I explain
that Koans are tests. We/You tidy up. Removed some excess wordage.
Made some "your should do this" statements more imperative. Made
mark up more consistent.
Support has been added for watchr, and this is very helpful while
walking the path to enlightenment as it keeps the users focus on
the koans and not on the repeated need to run rake after each edit.
However, only an experienced Rubyist would know how to install and
use watchr (or worse, they might just not notice the watchr config
file). So let's add an optional section to the README explaining
how to use watchr.
RVM allows the user to select a specific Ruby for a specific
project. It is common to put a .rvmrc config file in the root
of a project to select the Ruby automatically when the user
switches into that project.
The Ruby Koans should ignore this file if present and not mistake
it for a change to the Koans themselves. There are other ways
of choosing a Ruby to use, and use of RVM is not mandated by the
Koans so ignoring seems like the right solution.
Patches were submitted against the koans directory rather than the
src directory. This lead to potential problems when we regenerate the
koans directory from scratch, leading to the very real possibility
that changes could be lost.
Please make all changes to the src directory and use "rake gen" (or
"rake regen") to generate the koans directory as needed.