Fix yard doc typos, examples and tags

I guess the title is pretty much self explanatory ;)