Update the project to use yard for gem documentation in the gem spec and handle git-hub style markdown