expand discussion with examples, details, and references (#386)
expand discussion with examples, details, and references (#386)

* expand discussion

* Design for inheritance or prohibit it

* shorten

* shorten

GoogleCloudPlatform/cloud-opensource-java,GoogleCloudPlatform/cloud-opensource-java,GoogleCloudPlatform/cloud-opensource-java