Skip to content

Docs: switch default docs version from nightly to latest#16398

Merged
kevinjqliu merged 4 commits into
apache:mainfrom
MaxNevermind:fix-change-default-docs-version
May 18, 2026
Merged

Docs: switch default docs version from nightly to latest#16398
kevinjqliu merged 4 commits into
apache:mainfrom
MaxNevermind:fix-change-default-docs-version

Conversation

@MaxNevermind
Copy link
Copy Markdown
Contributor

@MaxNevermind MaxNevermind commented May 18, 2026

Background

The issue was first described by Kevin Liu(@kevinjqliu) as a follow-up task in an email thread from 5/13/2026 Docs: Are duplicated results in search on iceberg.apache.org a bug or a feature? on Iceberg's dev mailing list. Related PRs: #16368, #16371.

Problem statement

Both the "Docs" tab on https://iceberg.apache.org/ and the search index currently point to nightly (the most up-to-date documentation based on the main branch). This could be confusing if it includes changes that haven't been released yet. We would like to update both to link to latest (the most recent release version) instead.

Solution

  • Switches nightly and latest in md files, as the result latest become the first expandable container on the top and it becomes a default landing version which is what we want.
  • Exclude nightly from a search index and leave just latest as the only indexed version to align search with new default docs version.

@github-actions github-actions Bot added the docs label May 18, 2026
@MaxNevermind MaxNevermind changed the title Website: switch default docs version from nightly to latest Docs: switch default docs version from nightly to latest May 18, 2026
Copy link
Copy Markdown
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!

slight nit by adding a comment to explain the default landing page behavior

Comment thread site/mkdocs-dev.yml
Comment thread site/nav.yml
Co-authored-by: Kevin Liu <kevinjqliu@users.noreply.github.com>
@kevinjqliu kevinjqliu merged commit fab0d10 into apache:main May 18, 2026
7 checks passed
@kevinjqliu
Copy link
Copy Markdown
Contributor

its live, thanks!

Screenshot 2026-05-18 at 1 04 13 PM

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.

2 participants