update README and RDoc
maybe I should spell things correctly
fix bug that could cause incorrect "back-to" links