chitralverma opened a new issue, #7870: URL: https://github.com/apache/opendal/issues/7870
# Summary Several links to the Python API reference on the website return 404. # Cause The website links point to a flat `opendal.html` page, but the current MkDocs `nav` (`bindings/python/mkdocs.yml`) splits classes into per-page directory URLs (`api/operator/`, `api/async_operator/`, ...). No `opendal.html` is generated in the built `site/`, so every `opendal.html#...` deep link 404s. The class anchors (e.g. `#opendal.Operator`) exist only on the per-class pages, not on the top-level index. # Broken links | File | Link | | ---- | ---- | | `website/docs/20-bindings/python/01-overview.md:55` | `https://opendal.apache.org/docs/python/opendal.html#opendal.Operator` | | `website/docs/20-bindings/python/01-overview.md:56` | `https://opendal.apache.org/docs/python/opendal.html#opendal.AsyncOperator` | | `website/docs/20-bindings/python/02-getting-started.md:63` | `https://opendal.apache.org/docs/python/opendal.html#opendal.AsyncOperator` | # Fix Update the links to the paths the current build actually serves: - `https://opendal.apache.org/docs/python/api/operator/#opendal.Operator` - `https://opendal.apache.org/docs/python/api/async_operator/#opendal.AsyncOperator` # Note Docusaurus `onBrokenLinks: "throw"` does not catch these because they are absolute URLs into the static `/docs/python/` tree, not internal Docusaurus routes. A follow-up guard for these external-style links could prevent regressions. -- 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]
