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: improve UDF signature docs #8194

Merged
merged 7 commits into from
Feb 3, 2024
Merged

Conversation

NickCrews
Copy link
Contributor

Also added callout to optional args signature for builtin UDFs. Didn't for the other UDF implementations.

Fixes #8170 (comment)

Copy link
Contributor

github-actions bot commented Feb 1, 2024

ACTION NEEDED

Ibis follows the Conventional Commits specification for release automation.

The PR title and description are used as the merge commit message.

Please update your PR title and description to match the specification.

@lostmygithubaccount lostmygithubaccount changed the title Docs: improve UDF signature docs docs: improve UDF signature docs Feb 1, 2024
@lostmygithubaccount
Copy link
Member

the docs build error means you didn't check in (after rendering/previewing) the frozen execution outputs for the doc, so it's trying to run them

@cpcloud
Copy link
Member

cpcloud commented Feb 2, 2024

It looks like we are running snowflake queries in this part of the docs so for now someone with credentials will need to run it. In the meantime we should ideally move the snowflake stuff to a different document or remove it.

@NickCrews
Copy link
Contributor Author

(not looking at the code as I say this) can we just switch the examples to duckdb or something the doesn't need creds?

@NickCrews
Copy link
Contributor Author

Does the rest of the changes look good though?

@NickCrews
Copy link
Contributor Author

I removed/ported the snowflake stuff. we cab revert that if you want, but I think this is an improvement.

NickCrews and others added 7 commits February 3, 2024 07:01
- use "signature" not "input types"
- improve prose and emphasis.
Also added callout to optional args signature for builtin UDFs. Didn't for the other UDF implementations.
Co-authored-by: Phillip Cloud <417981+cpcloud@users.noreply.github.com>
- Using snowflake prevented me from running the example because I don't have the creds.
- Most of that content I don't think was needed.
- I moved the relevant part, with specifying the new name, into the duckdb section
- Also cleaned up imports to minimize things
@cpcloud cpcloud added docs-preview Add this label to trigger a docs preview docs Documentation related issues or PRs udf Issues related to user-defined functions duckdb The DuckDB backend snowflake The Snowflake backend labels Feb 3, 2024
@cpcloud
Copy link
Member

cpcloud commented Feb 3, 2024

@NickCrews Nah, let's keep it, this is strictly an improvement! Thank you!

@ibis-docs-bot ibis-docs-bot bot removed the docs-preview Add this label to trigger a docs preview label Feb 3, 2024
@ibis-docs-bot
Copy link

ibis-docs-bot bot commented Feb 3, 2024

@cpcloud
Copy link
Member

cpcloud commented Feb 3, 2024

@cpcloud cpcloud merged commit 3cdc6ce into ibis-project:main Feb 3, 2024
96 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation related issues or PRs duckdb The DuckDB backend snowflake The Snowflake backend udf Issues related to user-defined functions
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs: note how UDFs dont *need* arg types
3 participants