Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: fix formatting of request arg in docstring #1628

Merged
merged 2 commits into from
Mar 21, 2023
Merged

Conversation

parthea
Copy link
Contributor

@parthea parthea commented Mar 20, 2023

Fixes #1627 🦕

@product-auto-label product-auto-label bot added the size: l Pull request size is large. label Mar 20, 2023
@product-auto-label product-auto-label bot added size: m Pull request size is medium. and removed size: l Pull request size is large. labels Mar 20, 2023
@parthea parthea changed the title docs: fix formatting of requesst arg in docstring docs: fix formatting of request arg in docstring Mar 20, 2023
@parthea parthea force-pushed the fix-request-formatting branch 2 times, most recently from e3a3ab5 to 140e6c4 Compare March 20, 2023 14:49
@parthea parthea marked this pull request as ready for review March 20, 2023 15:02
@parthea parthea requested review from a team as code owners March 20, 2023 15:02
@parthea parthea added the owlbot:run Add this label to trigger the Owlbot post processor. label Mar 20, 2023
@gcf-owl-bot gcf-owl-bot bot removed the owlbot:run Add this label to trigger the Owlbot post processor. label Mar 20, 2023
@parthea parthea added the owlbot:run Add this label to trigger the Owlbot post processor. label Mar 20, 2023
@gcf-owl-bot gcf-owl-bot bot removed the owlbot:run Add this label to trigger the Owlbot post processor. label Mar 20, 2023
@@ -233,7 +233,7 @@ async def sample_list_buckets():

Args:
request (Optional[Union[google.cloud.logging_v2.types.ListBucketsRequest, dict]]):
The request object. The parameters to `ListBuckets`.
The request object. The parameters to ``ListBuckets``.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The issue to be fixed by this PR seems to be about spacing - are these additional backticks intentional side effects? Will this cause issues with downstream documentation page generation?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't expect any issues as we're using the same code a few lines down. There will be changes in downstream documentation pages but I believe in most cases it will be an improvement as previously lists were not being displayed properly. We can roll back this change if we encounter a significant issue downstream.

image

@parthea parthea merged commit 8b4f5ca into main Mar 21, 2023
@parthea parthea deleted the fix-request-formatting branch March 21, 2023 13:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size: m Pull request size is medium.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs build fails in python-monitoring due to incorrectly formatting list
2 participants