Further refine documentation based on my experience with the library.

There are no code changes.