Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Update the bookstore example.

Open
#5,505 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
grpc, python
Domain
api, documentation

Research direction

Start in the endpoints/bookstore-grpc-transcoding directory and compare its example protos with the API design guidelines linked in the issue. Update the sample so its standard methods follow those guidelines and the example is clearly canonical.

Written by the indexing model from the issue text.

Description

priority: p3 samples type: cleanup

In which file did you encounter the issue?

https://github.com/GoogleCloudPlatform/python-docs-samples/tree/master/endpoints/bookstore-grpc-transcoding

Describe the issue

We got a bug report for https://cloud.google.com/apis/design/ (internal bug number: 148977958), claiming that the example protos here are inconsistent with the standard methods design guidelines in the style guide. The user claims not to know which is authoritative.

I checked, and this is true, and it would be nice if the sample here was canonical (although I expect that to be low priority, natch).

Dominant language
Jupyter Notebook
Stars
8.1k
Forks
6.7k
Avg merge
4d 4h
Merged PRs (30d)
8

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from GoogleCloudPlatform/python-docs-samples

All issues in GoogleCloudPlatform/python-docs-samples

Similar issues

More Backend & API Design issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.