Apply @jonhoo's suggested documentation changes.

[davidbarsky]

In the the interest of moving tracing out of the main tokio repository, I've preemptively merged tokio-rs/tokio#1148 before all of @jonhoo's suggestions could be applied. This issue tracks the application of Jon's suggestions in this repository.