Update Doc Comment Link Guidelines

This fixes #748 with some examples, and some re-written text.

I also punched up some `{% prettify none %}` styles, so that we can have plain-jane, non-white-background code blocks.

Staged at: https://issue-748-dot-dart-lang.appspot.com/articles/doc-comment-guidelines/#links