moved rdoc README to markdown because its easier, toy with http://dillinger.io/ to experiment in formatting; you will like it for sure
ok, this is the final migration fix for sure. i should have branched off. can we start doing a branch/pull-request for code-review model for branch-merging?