This is an automated email from the ASF dual-hosted git repository.
uros-b pushed a commit to branch branch-4.x
in repository https://gitbox.apache.org/repos/asf/spark.git
The following commit(s) were added to refs/heads/branch-4.x by this push:
new 445553331e51 [SPARK-57622][DOC] Add navigation subsections to the Data
Source V2 documentation page
445553331e51 is described below
commit 445553331e51f1e21d4afe8d8165a2afe8c9c245
Author: Szehon Ho <[email protected]>
AuthorDate: Tue Jun 23 15:14:49 2026 +0200
[SPARK-57622][DOC] Add navigation subsections to the Data Source V2
documentation page
### What changes were proposed in this pull request?
This PR improves the left-navigation experience for the Data Source V2
documentation page in the SQL guide:
- Renames the page `docs/sql-data-sources-v2.md`
(`sql-data-sources-v2.html`) to `docs/sql-v2-data-sources.md`
(`sql-v2-data-sources.html`). The page content is unchanged (pure rename).
- Adds per-section sub-items for the page to the SQL guide sidebar
(`docs/_data/menu-sql.yaml`): Overview, Entry Points, Catalog Interfaces,
Table, View, Read Path, Write Path, Row-Level DML, Expressions, Streaming, and
Further Reading.
- Updates the internal link in `docs/sql-ref-syntax-dml-merge-into.md` to
point at the new URL.
### Why are the changes needed?
In the SQL guide sidebar, selecting **Data Source V2** incorrectly expanded
the sibling **Data Sources** group instead of the Data Source V2 entry, and the
page exposed no section links in the sidebar.
The sidebar template (`docs/_includes/nav-left.html`) decides which group
to expand by checking whether the current page URL contains a group's URL with
`.html` stripped (i.e. a substring/prefix match). Because the page URL leaf
`sql-data-sources-v2` contains the `sql-data-sources` prefix of the **Data
Sources** group, that group was matched and expanded.
Renaming the page to `sql-v2-data-sources` removes the prefix overlap so
the correct entry is selected, and the new sub-items make the page's sections
navigable from the sidebar (consistent with other entries such as Performance
Tuning).
### Does this PR introduce _any_ user-facing change?
No (documentation-only). Note that the Data Source V2 page URL changes from
`sql-data-sources-v2.html` to `sql-v2-data-sources.html`; no redirect is added
for the old URL.
The page is not yet released in Spark 4.2
### How was this patch tested?
Built the docs site locally (`SKIP_API=1 bundle exec jekyll build`) and
verified in the rendered sidebar that:
- selecting **Data Source V2** expands its own section links,
- the **Data Sources** group is no longer expanded on the Data Source V2
page,
- other pages (e.g. Parquet Files, SQL Reference subpages) still expand
their groups as before.
### Was this patch authored or co-authored using generative AI tooling?
Generated-by: Cursor
Closes #56680 from szehon-ho/docs-sql-dsv2-nav-sections.
Authored-by: Szehon Ho <[email protected]>
Signed-off-by: Uros Bojanic <[email protected]>
(cherry picked from commit dd01fe5f825a1387f2a6c43ff98e47addc5e2507)
Signed-off-by: Uros Bojanic <[email protected]>
---
docs/_data/menu-sql.yaml | 25 +++++++++++++++++++++-
docs/sql-ref-syntax-dml-merge-into.md | 2 +-
...l-data-sources-v2.md => sql-v2-data-sources.md} | 0
3 files changed, 25 insertions(+), 2 deletions(-)
diff --git a/docs/_data/menu-sql.yaml b/docs/_data/menu-sql.yaml
index b28cf2076f54..8b3c38523c07 100644
--- a/docs/_data/menu-sql.yaml
+++ b/docs/_data/menu-sql.yaml
@@ -51,7 +51,30 @@
- text: Troubleshooting
url: sql-data-sources-troubleshooting.html
- text: Data Source V2
- url: sql-data-sources-v2.html
+ url: sql-v2-data-sources.html
+ subitems:
+ - text: Overview
+ url: sql-v2-data-sources.html#overview
+ - text: Entry Points
+ url: sql-v2-data-sources.html#entry-points
+ - text: Catalog Interfaces
+ url: sql-v2-data-sources.html#catalog-interfaces
+ - text: Table
+ url: sql-v2-data-sources.html#table
+ - text: View
+ url: sql-v2-data-sources.html#view
+ - text: Read Path
+ url: sql-v2-data-sources.html#read-path
+ - text: Write Path
+ url: sql-v2-data-sources.html#write-path
+ - text: Row-Level DML
+ url: sql-v2-data-sources.html#row-level-dml
+ - text: Expressions
+ url: sql-v2-data-sources.html#expressions
+ - text: Streaming
+ url: sql-v2-data-sources.html#streaming
+ - text: Further Reading
+ url: sql-v2-data-sources.html#further-reading
- text: Performance Tuning
url: sql-performance-tuning.html
subitems:
diff --git a/docs/sql-ref-syntax-dml-merge-into.md
b/docs/sql-ref-syntax-dml-merge-into.md
index 90731105d491..c6b74dcad4b6 100644
--- a/docs/sql-ref-syntax-dml-merge-into.md
+++ b/docs/sql-ref-syntax-dml-merge-into.md
@@ -27,7 +27,7 @@ updated or deleted, and new rows are inserted from the
source, according to the
apply. All of these row-level changes are performed as a single atomic
operation.
`MERGE INTO` is supported on tables backed by
-[Data Source V2](sql-data-sources-v2.html#row-level-dml) connectors that
support row-level operations.
+[Data Source V2](sql-v2-data-sources.html#row-level-dml) connectors that
support row-level operations.
### Syntax
diff --git a/docs/sql-data-sources-v2.md b/docs/sql-v2-data-sources.md
similarity index 100%
rename from docs/sql-data-sources-v2.md
rename to docs/sql-v2-data-sources.md
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
