Revise docs to try to make them clearer.
Revise docs to try to make them clearer.

MOE_MIGRATED_REVID=212059300

google/error-prone,cushon/error-prone,cushon/error-prone,cushon/error-prone,google/error-prone,cushon/error-prone