Improve README.md

README.md

@@ -5,7 +5,7 @@
 The grpc-gateway is a plugin of the Google protocol buffers compiler
 [protoc](https://github.com/protocolbuffers/protobuf).
 It reads protobuf service definitions and generates a reverse-proxy server which
-'translates a RESTful HTTP API into gRPC. This server is generated according to the
+translates a RESTful HTTP API into gRPC. This server is generated according to the
 [`google.api.http`](https://github.com/googleapis/googleapis/blob/master/google/api/http.proto#L46)
 annotations in your service definitions.
 
@@ -28,7 +28,7 @@ gRPC is great -- it generates API clients and server stubs in many programming
 languages, it is fast, easy-to-use, bandwidth-efficient and its design is
 combat-proven by Google. However, you might still want to provide a traditional
 RESTful JSON API as well. Reasons can range from maintaining
-backwards-compatibility, supporting languages or clients not well supported by
+backward-compatibility, supporting languages or clients that are not well supported by
 gRPC, to simply maintaining the aesthetics and tooling involved with a RESTful
 JSON architecture.
 
@@ -122,6 +122,11 @@ annotation to your .proto file
    +  }
     }
    ```
+   >You will need to provide the required third party protobuf files to the `protoc` compiler.
+   >They are included in this repo under the `third_party/googleapis` folder, and we recommend copying
+   >them into your `protoc` generation file structure. If you've structured your proto files according
+   >to something like [the Buf style guide](https://buf.build/docs/style-guide#files-and-packages),
+   >you could copy the files into a top-level `./google` folder.
 
    See [a_bit_of_everything.proto](examples/internal/proto/examplepb/a_bit_of_everything.proto)
    for examples of more annotations you can add to customize gateway behavior
@@ -265,12 +270,12 @@ example:
 ```
 
 `protoc-gen-grpc-gateway` supports custom mapping from Protobuf `import` to
-Golang import paths. They are compatible to
-[the parameters with same names in `protoc-gen-go`](https://github.com/golang/protobuf#parameters).
+Golang import paths. They are compatible with
+[the parameters with the same names in `protoc-gen-go`](https://github.com/golang/protobuf#parameters).
 
 In addition we also support the `request_context` parameter in order to use the
 `http.Request`'s Context (only for Go 1.7 and above). This parameter can be
-useful to pass request scoped context between the gateway and the gRPC service.
+useful to pass the request-scoped context between the gateway and the gRPC service.
 
 `protoc-gen-grpc-gateway` also supports some more command line flags to control
 logging. You can give these flags together with parameters above. Run
@@ -304,10 +309,10 @@ gRPC-gateway, and a gRPC server, see
 ### Supported
 
 * Generating JSON API handlers.
-* Method parameters in request body.
-* Method parameters in request path.
+* Method parameters in the request body.
+* Method parameters in the request path.
 * Method parameters in query string.
-* Enum fields in path parameter (including repeated enum fields).
+* Enum fields in the path parameter (including repeated enum fields).
 * Mapping streaming APIs to newline-delimited JSON streams.
 * Mapping HTTP headers with `Grpc-Metadata-` prefix to gRPC metadata (prefixed with `grpcgateway-`)
 * Optionally emitting API definitions for