minor fixes

- adding 'parent' concept in the resource model
- fixing protoc docs

DEVELOPMENT.md

@@ -5,5 +5,5 @@
 The standard GoLang toolchain is used, with the addition of protobuf for
 compiling the resource definition.
 
-1. `protoc ./aepc/schema/resourcedefinition.proto --go_opt paths=source_relative --go_out=.`
+1. `protoc ./schema/resourcedefinition.proto --go_opt paths=source_relative --go_out=.`
 2. `go build main.go`

examples/bookstore.proto

@@ -1,8 +1,12 @@
+// NOTE: since we are missing some proto annotations that
+// must be added, the proto representation is outdated. See bookstore.yaml
 syntax = "proto3";
 package tutorial;
 option go_package = "proto";
 
-service Bookstore {}
+// bookstore.examples.com
+service Bookstore {
+}
 
 message Book {
 

examples/bookstore.yaml

@@ -1,3 +1,6 @@
-name: Bookstore
+name: bookstore.example.com
 resources:
-  - kind: Book
+  - kind: Book
+    parents:
+    - "bookstore.example.com/Publisher"
+  - kind: Publisher

examples/bookstore.yaml.output.proto

@@ -18,6 +18,20 @@ message ReadBookRequest {
   string path = 1;
 }
 
+message Publisher {
+  string path = 1;
+}
+
+message CreatePublisherRequest {
+  string id = 1;
+
+  Publisher resource = 2;
+}
+
+message ReadPublisherRequest {
+  string path = 1;
+}
+
 service Bookstore {
   rpc CreateBook ( CreateBookRequest ) returns ( Book ) {
     option (google.api.http) = { post: "/book" };
@@ -26,4 +40,12 @@ service Bookstore {
   rpc ReadBook ( ReadBookRequest ) returns ( Book ) {
     option (google.api.http) = { get: "/{path=book/*}" };
   }
+
+  rpc CreatePublisher ( CreatePublisherRequest ) returns ( Publisher ) {
+    option (google.api.http) = { post: "/publisher" };
+  }
+
+  rpc ReadPublisher ( ReadPublisherRequest ) returns ( Publisher ) {
+    option (google.api.http) = { get: "/{path=publisher/*}" };
+  }
 }

schema/resourcedefinition.proto

@@ -13,10 +13,14 @@ message Service {
 }
 
 message Resource {
-  // Kind is the type of the resource
+  // The type of the resource. Used to programmatically
+  // refer to and identify the resource.
   string kind = 1;
-  repeated string parents = 2;
-  map<string, Property> properties = 3;
+  // The plural of the resource. Used in documentation.
+  string plural = 2;
+  // The list of parent resources, referred to via the kind.
+  repeated string parents = 3;
+  map<string, Property> properties = 4;
   // TODO: add method support
   // repeated Method methods = 3;
 }