Update broker API package. (#334)

* Update broker package.

* change to dev

* hide from docs

Author: xiaolanz

Makefile

@@ -145,15 +145,15 @@ generate: generate-broker-go generate-mesh-go generate-mixer-go generate-routing
 # broker/...
 #####################
 
-broker_v1_path := broker/v1/config
+broker_v1_path := broker/dev
 broker_v1_protos := $(shell find $(broker_v1_path) -type f -name '*.proto' | sort)
 broker_v1_pb_gos := $(broker_v1_protos:.proto=.pb.go)
-broker_v1_pb_doc := $(broker_v1_path)/istio.broker.v1.config.pb.html
+broker_v1_pb_doc := $(broker_v1_path)/istio.broker.dev.pb.html
 
 generate-broker-go: $(broker_v1_pb_gos) $(broker_v1_pb_doc)
 
 $(broker_v1_pb_gos) $(broker_v1_pb_doc): $(broker_v1_protos) | depend $(protoc_gen_go) $(protoc_bin)
-	## Generate broker/v1/config/*.pb.go + $(broker_v1_pb_doc)
+	## Generate broker/dev/*.pb.go + $(broker_v1_pb_doc)
 	$(protoc) $(proto_path) $(protoc_gen_go_plugin) $(protoc_gen_docs_plugin)$(broker_v1_path) $^
 
 clean-broker-generated:

broker/dev/istio.broker.dev.pb.html

@@ -0,0 +1,6 @@
+---
+title: Service Broker
+overview: Configuration affecting the Istio service broker
+location: https://istio.io/docs/reference/config/istio.broker.dev.html
+layout: protoc-gen-docs
+---

broker/v1/config/service_class.pb.go renamed to broker/dev/service_class.pb.go

@@ -15,12 +15,13 @@ syntax = "proto3";
 
 // $title: Service Broker
 // $overview: Configuration affecting the Istio service broker
-// $location: https://istio.io/docs/reference/config/istio.broker.v1.config.html
+// $location: https://istio.io/docs/reference/config/istio.broker.dev.html
 
-package istio.broker.v1.config;
+package istio.broker.dev;
 
-option go_package="istio.io/api/broker/v1/config";
+option go_package="istio.io/api/broker/dev";
 
+// $hide_from_docs
 // ServiceClass defines a service that are exposed to Istio service consumers.
 // The service is linked into one or more ServicePlan.
 message ServiceClass {
@@ -31,12 +32,14 @@ message ServiceClass {
   CatalogEntry entry = 2;
 }
 
+// $hide_from_docs
 // Deployment defines how the service instances are deployed.
 message Deployment {
   // For truely multi-tenant service, the deployed service instance name.
   string instance = 1;
 }
 
+// $hide_from_docs
 // CatalogEntry defines listing information for this service within the exposed
 // catalog.  The message is a subset of OSBI service fields defined in
 // https://github.com/openservicebrokerapi

broker/v1/config/service_class.proto renamed to broker/dev/service_class.proto

@@ -13,10 +13,11 @@
 //   limitations under the License.
 syntax = "proto3";
 
-package istio.broker.v1.config;
+package istio.broker.dev;
 
-option go_package="istio.io/api/broker/v1/config";
+option go_package="istio.io/api/broker/dev";
 
+// $hide_from_docs
 // ServicePlan defines the type of services available to Istio service
 // consumers.  One or more services are included in a plan. The plan is flexible
 // and subject to change along with business requirements.
@@ -30,6 +31,7 @@ message ServicePlan {
   repeated string services = 2;
 }
 
+// $hide_from_docs
 // CatalogPlan defines listing information for this service plan within the
 // exposed catalog.  The message is a subset of OSBI plan fields defined in
 // https://github.com/openservicebrokerapi