Fix some issues with the YARD documentation

While reading through the docs I found a few typos and some confusing language. There was also an issue with the rendering of some code examples in Channel – the examples were being moved around on the page.