Multiple documentation related changes.

Fixed the link references across the document set.

Also, started using the Yard reference tags to include example code where appropriate.
Added example code to the Gem.