Skip to content

chore: add contributing guidelines for bigframes.bigquery#16972

Open
tswast wants to merge 4 commits intomainfrom
tswast-patch-2
Open

chore: add contributing guidelines for bigframes.bigquery#16972
tswast wants to merge 4 commits intomainfrom
tswast-patch-2

Conversation

@tswast
Copy link
Copy Markdown
Contributor

@tswast tswast commented May 6, 2026

Add contributing guidelines for bigframes.bigquery APIs, detailing input and output policies, naming conventions, and examples for SQL operations.

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:

  • Make sure to open an issue as a bug/issue before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
  • Ensure the tests and linter pass
  • Code coverage does not decrease (if any source code was changed)
  • Appropriate docs were updated (if necessary)

Fixes #<issue_number_goes_here> 🦕

Add contributing guidelines for bigframes.bigquery APIs, detailing input and output policies, naming conventions, and examples for SQL operations.
@tswast tswast requested review from a team as code owners May 6, 2026 20:16
@tswast tswast requested review from TrevorBergeron and removed request for a team May 6, 2026 20:16
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a new specification document, bigframes-bigquery-contributing.md, which defines the input and output policies for mapping BigQuery SQL functions to Python. The documentation covers type mappings, naming conventions, and provides examples for PIVOT and UNPIVOT operations. Feedback identifies several issues, including an incorrect usage example for the unpivot function, fragmented sentences in the internal expressions section, and multiple typos or formatting errors throughout the document.

Comment thread packages/bigframes/specs/bigframes-bigquery-contributing.md
Comment thread packages/bigframes/specs/bigframes-bigquery-contributing.md Outdated
Comment on lines +214 to +222
Prefer returning a `bigframes.pandas.DataFrame` that wraps a `bigframes.bigframes.core`


```
.bigframe_node.BigFrameNode. See from_bq_data_source in bigframes.core
```


`.array_value.ArrayValue`, as an example.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

This section appears to be fragmented with incomplete sentences and incorrect module paths (e.g., bigframes.bigframes.core). It looks like a copy-paste or formatting error occurred during the creation of this document.

Comment thread packages/bigframes/specs/bigframes-bigquery-contributing.md Outdated
Comment thread packages/bigframes/specs/bigframes-bigquery-contributing.md Outdated
tswast and others added 3 commits May 6, 2026 15:34
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant