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

Minor: consolidate ConfigExtension example into API docs #13954

Merged
merged 7 commits into from
Jan 2, 2025

Conversation

alamb
Copy link
Contributor

@alamb alamb commented Dec 31, 2024

Which issue does this PR close?

Rationale for this change

THe example for ConfigExtensions is:

  1. Not listed in the README.md and thus hard to find
  2. An API example rather than an end to end example

Thus I think it belongs in the API docs rather than a standalone example

What changes are included in this PR?

Move the example for ConfigExtension into the API docs

Are these changes tested?

Yes by CI

Are there any user-facing changes?

more API docs

@github-actions github-actions bot added the common Related to common crate label Dec 31, 2024
@alamb alamb changed the title Alamb/consolidate config extensions doc Minor: consolidate ConfigExtension example into API docs Dec 31, 2024
datafusion-examples/README.md Outdated Show resolved Hide resolved
/// This mechanism can be used to pass configuration to user defined functions
/// or optimizer passes
///
/// # Example
Copy link
Contributor Author

Choose a reason for hiding this comment

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

this is the same example, moved into the docs

@alamb alamb added the documentation Improvements or additions to documentation label Dec 31, 2024
@github-actions github-actions bot removed the documentation Improvements or additions to documentation label Dec 31, 2024
Copy link
Member

@jonahgao jonahgao left a comment

Choose a reason for hiding this comment

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

LGTM

@@ -901,6 +941,8 @@ pub trait ConfigExtension: ExtensionOptions {
}

/// An object-safe API for storing arbitrary configuration
/// do
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't seem to be displayed very well in cargo doc.
CleanShot 2025-01-01 at 23 44 10@2x

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thank you for this good catch. I am not sure why I made this change. Fixed in c433575

It looks much better now

Screenshot 2025-01-01 at 12 44 19 PM

@jonahgao
Copy link
Member

jonahgao commented Jan 2, 2025

Thanks @alamb

@jonahgao jonahgao merged commit 259443d into apache:main Jan 2, 2025
26 checks passed
@alamb alamb deleted the alamb/consolidate_config_extensions_doc branch January 2, 2025 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
common Related to common crate
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants