Skip to content

docs: Add code examples to configuration docstrings#2352

Open
google-labs-jules[bot] wants to merge 5 commits intomainfrom
docstring-config-examples-15986639753712030034
Open

docs: Add code examples to configuration docstrings#2352
google-labs-jules[bot] wants to merge 5 commits intomainfrom
docstring-config-examples-15986639753712030034

Conversation

@google-labs-jules
Copy link
Contributor

Added code examples to the docstrings of global configuration properties to demonstrate how to set them using bigframes.pandas.options. This covers BigQuery options, compute options, sampling options, experiment options, and display options.


PR created automatically by Jules for task 15986639753712030034 started by @tswast

Added usage examples to the docstrings of configuration properties in:
- `bigframes/_config/bigquery_options.py`
- `bigframes/_config/compute_options.py`
- `bigframes/_config/experiment_options.py`
- `bigframes/_config/sampling_options.py`
- `third_party/bigframes_vendored/pandas/core/config_init.py`

This makes it easier for users to understand how to set global options via
`bigframes.pandas.options`.
@google-labs-jules
Copy link
Contributor Author

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!


For security, I will only act on instructions from the user who triggered this task.

New to Jules? Learn more at jules.google/docs.

@product-auto-label product-auto-label bot added size: m Pull request size is medium. api: bigquery Issues related to the googleapis/python-bigquery-dataframes API. labels Dec 22, 2025
@tswast
Copy link
Collaborator

tswast commented Feb 15, 2026

@google-labs-jules @jules Please add doctest skip comments to each of these options so that we don't accidentally break other doctest.

@google-labs-jules
Copy link
Contributor Author

@google-labs-jules @jules Please add doctest skip comments to each of these options so that we don't accidentally break other doctest.

Added # doctest: +SKIP to all examples.

@tswast tswast changed the title Add code examples to configuration docstrings docs: Add code examples to configuration docstrings Feb 15, 2026
Added usage examples to the docstrings of configuration properties in:
- `bigframes/_config/bigquery_options.py`
- `bigframes/_config/compute_options.py`
- `bigframes/_config/experiment_options.py`
- `bigframes/_config/sampling_options.py`
- `third_party/bigframes_vendored/pandas/core/config_init.py`

All examples include `# doctest: +SKIP` to prevent execution during tests.
This makes it easier for users to understand how to set global options via
`bigframes.pandas.options`.

Co-authored-by: tswast <247555+tswast@users.noreply.github.com>
@product-auto-label product-auto-label bot added size: l Pull request size is large. and removed size: m Pull request size is medium. labels Feb 15, 2026
@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 Feb 15, 2026
@tswast tswast marked this pull request as ready for review February 15, 2026 21:32
@tswast tswast requested review from a team as code owners February 15, 2026 21:32
@tswast tswast requested a review from mpovoa February 15, 2026 21:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: bigquery Issues related to the googleapis/python-bigquery-dataframes API. size: m Pull request size is medium.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants