Override the yard doc generate to fix hash links in the readme

The readme uses GitHub hash links which go something like
like #Another_section.

This changes the yard generator to make the transformation to
capitalized underscored hash links so they work both on GitHub
and in the yard generated documentation.

Fix #458