documentation of semantics of endpoint declarations #212
Comments
|
Thank you for your feedback. We should definitely have had such documentation. |
|
@sdemos thank you so much for that link. I was having the same problem with finding documentation. |
|
@sdemos are you going to submit a PR to close this out? |
sdemos
added a commit
to sdemos/grpc-gateway
that referenced
this issue
Sep 7, 2016
This commit adds links to the google cloud platform's documentation on the custom options used by grpc-gateway to generate your http proxy. This documentation has information about how path, query, and body parameters are handled, as well as specific assumptions about the arguments present for different http methods. Fixes grpc-ecosystem#212
adasari
pushed a commit
to adasari/grpc-gateway
that referenced
this issue
Apr 9, 2020
This commit adds links to the google cloud platform's documentation on the custom options used by grpc-gateway to generate your http proxy. This documentation has information about how path, query, and body parameters are handled, as well as specific assumptions about the arguments present for different http methods. Fixes grpc-ecosystem#212
This was referenced Apr 7, 2022
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
After working with this project for a little while, I finally found Google's description of the semantics that are used in this package. It would be super helpful if that (or a better version of that) were linked to prominently in the README.md. It would be even better if the specific way that this library implemented that description was documented, so that someone learning how to use this library doesn't have to just mess around with the library to see how it works. The implicit generation of query parameters especially threw me, I didn't realize that this library could even do that until someone mentioned it in another issue.
The text was updated successfully, but these errors were encountered: