fix wording in README
modernize AsciiDoc markup example in rdoc