Skip to content

Conversation

@MeongSuper
Copy link
Contributor

@MeongSuper MeongSuper commented Oct 14, 2025

Restored the missing Delta Lake Migration page in the documentation navigation.

Changes:

  • Updated docs/mkdocs.yml to include a Migration section:
    • table-migration.md
    • hive-migration.md
    • delta-lake-migration.md

Verified locally using: mkdocs serve -f docs/docs/mkdocs.yml

Migration menu and Delta Lake Migration page

Related Issues:
Fixes #14309
See also #13761 (original missing migration issue)

@github-actions github-actions bot added the docs label Oct 14, 2025
@ebyhr
Copy link
Contributor

ebyhr commented Oct 14, 2025

Could you add a screenshot to the PR description?

@MeongSuper
Copy link
Contributor Author

Could you add a screenshot to the PR description?

Added the screenshot to the PR description

@ebyhr
Copy link
Contributor

ebyhr commented Oct 15, 2025

The style in the screenshot is different from the actual generated page. You can run make serve command in site directory instead. The generated page will be like this.

Screenshot 2025-10-15 at 15 34 03

@MeongSuper
Copy link
Contributor Author

The style in the screenshot is different from the actual generated page. You can run make serve command in site directory instead. The generated page will be like this.

Screenshot 2025-10-15 at 15 34 03

I ran into an issue with make serve where it regenerates site/docs/docs/latest/mkdocs.yml from the remote iceberg_docs/docs worktree, which overwriting local changes.

So as workaround i did this:

  • Ran make serve from the site directory to generate the initial build structure.
  • Then, manually edited site/docs/docs/latest/mkdocs.yml to include the "Migration" section:
    - Migration:
        - Overview: table-migration.md
        - Hive Migration: hive-migration.md
        - Delta Lake Migration: delta-lake-migration.md
  • Served the site with mkdocs serve -f mkdocs.yml -v to verify the change in the sidebar nav
    Here’s the updated screenshot showing the "Migration" section in the sidebar, matching the production style:
image

This confirms the nav works locally. Let me know if this looks good or if there’s a better way to handle the build issue!

Copy link
Contributor

@kevinjqliu kevinjqliu left a comment

Choose a reason for hiding this comment

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

LGTM

rendered locally:
Image

@kevinjqliu
Copy link
Contributor

@MeongSuper you can merge main (with #14267) and run make serve-dev to render locally

@kevinjqliu kevinjqliu merged commit bbf5b8a into apache:main Nov 6, 2025
3 checks passed
@kevinjqliu
Copy link
Contributor

Thanks @MeongSuper and @ebyhr for the review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Add back Delta Lake Table Migration page to navigation bar

3 participants