Rewording to avoid overloading the word "we"

kubernetes-retired · Aug 30, 2017 · 2f3e2e0 · 2f3e2e0
1 parent e6b059c
commit 2f3e2e0
Showing 1 changed file with 9 additions and 6 deletions.
diff --git a/docs/walkthrough-1.7.md b/docs/walkthrough-1.7.md
@@ -8,14 +8,17 @@ of this repository.
 
 # Step 1 - Installing the UPS Broker Server
 
-In order to effectively demonstrate the service catalog, we need a sample
-broker server. We've built a "dummy" server called the User Provided Service
-(UPS) broker. You can find the codebase for that broker
+Since the Service Catalog provides a Kubernetes-native interface to an 
+[Open Service Broker API](https://openservicebrokerapi.org/) compatible broker
+server, we'll need to install one in order to proceed with a demo.
+
+In this repository, there's a simple, "dummy" server called the User Provided 
+Service (UPS) broker. The codebase for that broker is
 [here](https://github.com/kubernetes-incubator/service-catalog/tree/master/contrib/pkg/broker/user_provided/controller).
 
-We're going to deploy that broker to our Kubernetes cluster before proceeding,
-and we'll do so with the UPS helm chart. You can find details about that chart
-in the chart's 
+We're going to deploy the UPS broker to our Kubernetes cluster before 
+proceeding, and we'll do so with the UPS helm chart. You can find details about 
+that chart in the chart's 
 [README](https://github.com/kubernetes-incubator/service-catalog/blob/master/charts/ups-broker/README.md).
 
 Otherwise, to install with sensible defaults, run the following command: