Skip to content

Conversation

@manasa-manoj-nbr
Copy link
Contributor

Which issue does this PR close?

Rationale for this change

The SQL and DataFrame documentation links in the root README were broken and returned 404 errors.
This PR updates the URLs to point to the correct documentation paths, improving navigation for new users and contributors.

Are these changes tested?

Verified that the new links are valid and accessible.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Oct 24, 2025
README.md Outdated

"Out of the box,"
DataFusion offers [SQL] and [`Dataframe`] APIs, excellent [performance],
DataFusion offers [SQL](docs/source/user-guide/sql) and [Dataframe](docs/source/user-guide/dataframe.md) APIs, excellent [performance],
Copy link
Contributor

Choose a reason for hiding this comment

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

This line was copied from lib.rs (original PR: #12418).

//! "Out of the box," DataFusion offers [SQL] and [`Dataframe`] APIs,
//! excellent [performance], built-in support for CSV, Parquet, JSON, and Avro,

But they were missing the references:

//! [SQL]: https://datafusion.apache.org/user-guide/sql/index.html
//! [`DataFrame`]: dataframe::DataFrame

I think we should keep the original one and add references for them.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think especially for SQL it should link to a page instead of a directory.

For DataFrame I'm fine either way

Copy link
Contributor

@Jefffrey Jefffrey left a comment

Choose a reason for hiding this comment

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

Thanks for picking this up

README.md Outdated

"Out of the box,"
DataFusion offers [SQL] and [`Dataframe`] APIs, excellent [performance],
DataFusion offers [SQL](docs/source/user-guide/sql) and [Dataframe](docs/source/user-guide/dataframe.md) APIs, excellent [performance],
Copy link
Contributor

Choose a reason for hiding this comment

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

I think especially for SQL it should link to a page instead of a directory.

For DataFrame I'm fine either way

@manasa-manoj-nbr
Copy link
Contributor Author

I have updated the PR according to the code review. Please let me know if further changes are required, thanks! :)

@Jefffrey Jefffrey added this pull request to the merge queue Oct 25, 2025
Merged via the queue into apache:main with commit 2a82897 Oct 25, 2025
4 checks passed
@Jefffrey
Copy link
Contributor

Thanks 🎉

tobixdev pushed a commit to tobixdev/datafusion that referenced this pull request Nov 2, 2025
…pache#18274)

## Which issue does this PR close?
- Closes apache#18153

## Rationale for this change
The SQL and DataFrame documentation links in the root README were broken
and returned 404 errors.
This PR updates the URLs to point to the correct documentation paths,
improving navigation for new users and contributors.

## Are these changes tested?
Verified that the new links are valid and accessible.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SQL & Dataframe links broken on root readme

3 participants