kevinjqliu opened a new pull request, #16371: URL: https://github.com/apache/iceberg/pull/16371
## Problem Every versioned documentation page appears twice in the site search index. The root cause is that versioned doc sources live inside the parent MkDocs project's `docs_dir` (`site/docs/docs/<ver>/docs/`). This causes MkDocs to scan them directly *and* the `mkdocs-monorepo-plugin` to inject them at their canonical URLs — producing two rendered pages and two search entries per page. See https://github.com/apache/iceberg/pull/16368#pullrequestreview-4304117604 ## Solution Move the versioned docs worktree from `site/docs/docs/` (inside `docs_dir`) to `site/versioned-docs/` (outside `docs_dir`). Since the worktree is generated at build time by `dev/common.sh`, this is purely a path change in build scripts and nav configs — no content changes. With versioned sources outside `docs_dir`, MkDocs' own file scanner never sees them. Only the monorepo plugin renders them at their canonical URLs (`docs/<ver>/<page>/`), eliminating the duplicate entries entirely. ## Changes - `site/dev/common.sh` — worktree created at `versioned-docs/` instead of `docs/docs/` - `site/nav.yml`, `site/mkdocs-dev.yml` — `!include` paths updated - `site/README.md` — documentation updated to reflect new layout - `.gitignore` — ignore rule updated (`site/docs/docs/` → `site/versioned-docs/`) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
