Repository navigation
Documenting Gapic/Proto (autogen files) #1492
Description
Activity
My initial thoughts are that users who take advantage of GAX will be a bit more advanced. That being said, it might not be unreasonable to simply link them to the proto files being used? Then from within our library we can document the methods that expose said APIs
v2,v1beta1, etc.It also might benefit us to look into adding the feature discussed here - https://github.com/GoogleCloudPlatform/gcloud-common/issues/80
For now at least, I think linking to proto files is sufficient.
Cc: @omaray
We want the documentation for GAX (i.e. LanguageServiceApi). The generated files are more language-idiomatic and serve methods with additional features such as parameter-flattening / page-streaming, that are not seen in the proto files. We will also add auto-generated usage samples to individual method.
Correct. We want the documentation of GAPIC/GAX to show. Not every API will have a handwritten layer (or at least at the beginning). So we want to show the docs of the auto-gen too.
Just tagging as these are related: https://github.com/GoogleCloudPlatform/gcloud-common/issues/207
- changed the title
[-]Documenting Gapic (autogen files)[/-][+]Documenting Gapic/Proto (autogen files)[/+]on Jun 9, 2017 We're live with:
- Datastore: https://googlecloudplatform.github.io/google-cloud-node/#/docs/datastore/master/v1
- Logging: https://googlecloudplatform.github.io/google-cloud-node/#/docs/logging/master/v2
- Pub/Sub: https://googlecloudplatform.github.io/google-cloud-node/#/docs/pubsub/master/v1
- Spanner: https://googlecloudplatform.github.io/google-cloud-node/#/docs/spanner/master/v1
Reacted by Song WangReacted by Song WangReacted by Song Wang@stephenplusplus Looks amazing! We finally did it!! Really appreciate your great work!!!
- added a commit that references this issue
on Mar 11, 2026 - added a commit that references this issue
on Mar 27, 2026
Opening an issue to track discussion on how we should go about documenting GAX from within our library.