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

Improve contributor guide and main API landing page #5921

Merged
merged 1 commit into from
Apr 10, 2023

Conversation

alamb
Copy link
Contributor

@alamb alamb commented Apr 8, 2023

Move some content into the code organization section

Which issue does this PR close?

Part of #5501

Rationale for this change

I would like to make it easier for people to find, use, and contribute to DataFusion

What changes are included in this PR?

  1. Cleaning up the "landing" page in docs.rs https://docs.rs/datafusion/latest/datafusion/index.html (aka the main API documentation)
  2. Remove some duplicated content

Are these changes tested?

I reviewed the built docs locally

Are there any user-facing changes?

(Hopefully) Better docs

Move some content into the code organization section
@alamb alamb added the documentation Improvements or additions to documentation label Apr 8, 2023
@github-actions github-actions bot added core Core DataFusion crate logical-expr Logical plan and expressions physical-expr Physical Expressions sql SQL Planner and removed documentation Improvements or additions to documentation labels Apr 8, 2023

To run the examples, use the `cargo run` command, such as:

```bash
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moved from the main lib.rs guide

@@ -289,7 +289,7 @@ impl<T> Transformed<T> {
/// Helper trait for implementing [`TreeNode`] that have children stored as Arc's
///
/// If some trait object, such as `dyn T`, implements this trait,
/// its related Arc<dyn T> will automatically implement [`TreeNode`]
/// its related `Arc<dyn T>` will automatically implement [`TreeNode`]
Copy link
Contributor Author

Choose a reason for hiding this comment

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

drive by rustdoc cleanups

//!
//! [datafusion-examples]: https://github.com/apache/arrow-datafusion/tree/main/datafusion-examples
//!
//! ## Customization and Extension
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 rearranged and expanded the customization points

//!
//! ## Examples
//!
//! Examples are located in [datafusion-examples directory](https://github.com/apache/arrow-datafusion/tree/main/datafusion-examples)
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 moved the link to the other examples up with the other examples, and then moved the details on running closer to the examples themselves in the datafusion-examples directory


- [Apr 2023]: The Apache Arrow DataFusion Architecture talks series by @alamb
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moved to the main library docs

@alamb alamb changed the title Improve contributor guide Improve contributor guide and main API landing page Apr 8, 2023
@alamb alamb marked this pull request as ready for review April 8, 2023 12:33
@alamb alamb requested a review from andygrove April 8, 2023 12:38
Copy link
Member

@jackwener jackwener left a comment

Choose a reason for hiding this comment

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

Thanks @alamb

@alamb alamb merged commit e9edd0c into apache:main Apr 10, 2023
korowa pushed a commit to korowa/arrow-datafusion that referenced this pull request Apr 13, 2023
Move some content into the code organization section
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
core Core DataFusion crate logical-expr Logical plan and expressions physical-expr Physical Expressions sql SQL Planner
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants