finagle-docs: add more information about available annotations
finagle-docs: add more information about available annotations

Problem/Solution

The zipkin docs were lacking some annotations as well as discussion around
different types of annotations and how they should be used.

JIRA Issues: CSL-9042

Differential Revision: https://phabricator.twitter.biz/D396843

twitter/finagle,twitter/finagle,twitter/finagle,twitter/finagle,twitter/finagle