Use yard to generate documentation

This adds yard as a dev dependency so we can eventually use:

 bundle
 bundle exec yard

The redcarpet gem is used for syntax highlighting.

Tweaked the documentation title while at it.

Change-Id: I430fd2f21fac4e9f7c3cc2e996f41b78bde6a2eb