* add import guidance to library-level docs

* add import docs to other packages

* fix review comment

* clarify which libraries aren't meant to be directly imported

This is a variety of trivial fixes that I collected while going through the dartdocs.
This does contain some non-comment changes.