manuzhang opened a new issue, #18189: URL: https://github.com/apache/iceberg/issues/18189
### Problem `site/docs/terms.md` (line 31) links to the catalog properties page with a path that does not resolve in the built site, so the link 404s on https://iceberg.apache.org/terms/: ```markdown [Iceberg documentation](../../docs/docs/catalog-properties.md) ``` `../../docs/docs/catalog-properties.md` is where the page lives in the **source tree**. In the **built site** the versioned docs are published under `docs/latest/`, `docs/nightly/` and `docs/<version>/`; there is no `docs/docs/` path. ### How to reproduce Building the site reports it directly, through MkDocs' own link validation: ``` WARNING - Doc file 'terms.md' contains a link '../../docs/docs/catalog-properties.md', but the target is not found among documentation files. ``` ### Origin Introduced in #17153, which repointed this link after the refactor in #15848 removed the previous target, the `catalog-properties` anchor on `configuration.md`. That part was right — the old target no longer exists. The same PR also updated `open-api/rest-catalog-open-api.yaml`, and that change is correct: it uses the absolute URL `https://iceberg.apache.org/docs/latest/catalog-properties`. Only the Markdown link used a source-tree-relative path. ### Suggested fix ```markdown [Iceberg documentation](docs/latest/catalog-properties.md) ``` This matches the other versioned-doc links in the very same file, such as `docs/latest/partitioning.md` and `docs/latest/performance.md#scan-planning`. This is the only occurrence of the `../../docs/docs/` pattern in the repository — a repo-wide sweep of `site/` and `docs/` found no others. Happy to open a PR if that's useful. -- 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]
