Added YARD tags/comments to readable_text.rb

Also fixed a few other tags.