minor README copy edit (openshift#1656)

* minor README copy edit

* minor README copy edit

* Remove empty examples mention

Author: mmacy

Diff for: README.md

@@ -17,28 +17,28 @@ knowledge about how those services are created or managed.
 
 As an example:
 
-Most applications need a datastore of some kind.  The service-catalog allows
+Most applications need a datastore of some kind. The service-catalog allows
 Kubernetes applications to consume services like databases that exist
 _somewhere_ in a simple way:
 
-1.  A user wanting to consume a database in their application browses a list of
+1. A user wanting to consume a database in their application browses a list of
     available services in the catalog
-2.  The user asks for a new instance of that service to be _provisioned_
+2. The user asks for a new instance of that service to be _provisioned_
 
-     _Provisioning_ means that the broker somehow creates a new instance of a
-    service.  This could mean basically anything that results in a new instance
-    of the service becoming available.  Possibilities include: creating a new
-    set of Kubernetes resources in another namespace in the same Kubernetes
-    cluster as the consumer or a different cluster, or even creating a new
-    tenant in a multi-tenant SaaS system.  The point is that the
-    consumer doesn't have to be aware of or care at all about the details.
-3.  The user requests a _binding_ to use the service instance in their application
+    _Provisioning_ means that the broker somehow creates a new instance of a
+   service. This could mean basically anything that results in a new instance
+   of the service becoming available. Possibilities include: creating a new
+   set of Kubernetes resources in another namespace in the same Kubernetes
+   cluster as the consumer or a different cluster, or even creating a new
+   tenant in a multi-tenant SaaS system. The point is that the
+   consumer doesn't have to be aware of or care at all about the details.
+3. The user requests a _binding_ to use the service instance in their application
 
     Credentials are delivered to users in normal Kubernetes secrets and
     contain information necessary to connect to and authenticate to the
     service instance.
 
-For more introduction, including installation and self-guided demo 
+For more introduction, including installation and self-guided demo
 instructions, please see the [introduction](./docs/introduction.md) doc.
 
 For more details about the design and features of this project see the
@@ -52,11 +52,11 @@ For more details about the design and features of this project see the
 
 ---
 
-### Overall Status
+### Project Status
 
 We are currently working toward a beta-quality release to be used in conjunction with
 Kubernetes 1.8. See the
-[milestones list](https://github.com/kubernetes-incubator/service-catalog/milestones?direction=desc&sort=due_date&state=open) 
+[milestones list](https://github.com/kubernetes-incubator/service-catalog/milestones?direction=desc&sort=due_date&state=open)
 for information about the issues and PRs in current and future milestones.
 
 The project [roadmap](https://github.com/kubernetes-incubator/service-catalog/wiki/Roadmap)
@@ -70,45 +70,43 @@ for more information.
 
 Our goal is to have extensive use-case and functional documentation.
 
-See the [main Kubernetes docs](https://kubernetes.io/docs/concepts/service-catalog/)
-and additional documentation [here](./docs/v1).
+See the [Service Catalog documentation](https://kubernetes.io/docs/concepts/service-catalog/)
+on the main Kubernetes site, and the [project documentation](./docs/README.md) here on GitHub.
 
-See [here](https://github.com/kubernetes-incubator/service-catalog/wiki/Examples) for examples and
-[here](https://github.com/openservicebrokerapi/servicebroker/blob/master/gettingStarted.md) for
-broker servers that are compatible with this software.
+For details on broker servers that are compatible with this software, see the
+Open Service Broker API project's [Getting Started guide](https://github.com/openservicebrokerapi/servicebroker/blob/master/gettingStarted.md).
 
 ### Terminology
 
 This project's problem domain contains a few inconvenient but unavoidable
-overloads with other Kubernetes terms.  Check out our [terminology page](./terminology.md)
+overloads with other Kubernetes terms. Check out our [terminology page](./terminology.md)
 for definitions of terms as they are used in this project.
 
 ### Contributing
 
-Interested in contributing?  Check out the [contributing documentation](./CONTRIBUTING.md).
+Interested in contributing? Check out the [contribution guidelines](./CONTRIBUTING.md).
 
 Also see the [developer's guide](./docs/devguide.md) for information on how to
 build and test the code.
 
 We have weekly meetings - see
 [Kubernetes SIGs](https://github.com/kubernetes/community/blob/master/sig-list.md)
-(search for "Service Catalog") for the exact date and time. Our agenda/notes
-doc can be found
-[here](https://docs.google.com/document/d/17xlpkoEbPR5M6P5VDzNx17q6-IPFxKyebEekCGYiIKM/edit)
+(search for "Service Catalog") for the exact date and time. For meeting agendas
+and notes, see [Kubernetes SIG Service Catalog Agenda](https://docs.google.com/document/d/17xlpkoEbPR5M6P5VDzNx17q6-IPFxKyebEekCGYiIKM/edit).
 
-Previous Agenda notes are also available:
+Previous meeting notes are also available:
 [2016-08-29 through 2017-09-17](https://docs.google.com/document/d/10VsJjstYfnqeQKCgXGgI43kQWnWFSx8JTH7wFh8CmPA/edit).
 
 ### Kubernetes Incubator
 
 This is a [Kubernetes Incubator project](https://github.com/kubernetes/community/blob/master/incubator.md).
-The project was established 2016-Sept-12.  The incubator team for the project is:
+The project was established 2016-Sept-12. The incubator team for the project is:
 
 - Sponsor: Brian Grant ([@bgrant0607](https://github.com/bgrant0607))
 - Champion: Paul Morie ([@pmorie](https://github.com/pmorie))
 - SIG: [sig-service-catalog](https://github.com/kubernetes/community/tree/master/sig-service-catalog)
 
-For more information about sig-service-catalog such as meeting times and agenda,
+For more information about sig-service-catalog, such as meeting times and agenda,
 check out the [community site](https://github.com/kubernetes/community/tree/master/sig-service-catalog).
 
 ### Code of Conduct