chitralverma opened a new pull request, #7872:
URL: https://github.com/apache/opendal/pull/7872

   # Which issue does this PR close?
   
   Closes #7870.
   
   # Rationale for this change
   
   Several links to the Python API reference on the website return 404. They 
point to a flat `opendal.html` page, but the current MkDocs `nav` 
(`bindings/python/mkdocs.yml`) emits per-page directory URLs (`api/operator/`, 
`api/async_operator/`). No `opendal.html` is generated, so the deep links break.
   
   # What changes are included in this PR?
   
   Update the `Operator` and `AsyncOperator` reference links in the Python 
binding docs to the paths the build actually serves:
   
   - `docs/python/opendal.html#opendal.Operator` → 
`docs/python/api/operator/#opendal.Operator`
   - `docs/python/opendal.html#opendal.AsyncOperator` → 
`docs/python/api/async_operator/#opendal.AsyncOperator`
   
   Files: `website/docs/20-bindings/python/01-overview.md`, 
`website/docs/20-bindings/python/02-getting-started.md`.
   
   Validated by building the docs (`mkdocs build`): `api/operator/index.html` 
and `api/async_operator/index.html` exist and contain the `opendal.Operator` / 
`opendal.AsyncOperator` anchors, while `opendal.html` does not exist.
   
   # Are there any user-facing changes?
   
   Documentation links only. No API or behavior changes.
   
   # AI Usage Statement
   
   Implemented with an AI coding agent (opencode, Claude Opus). Validated 
locally with `mkdocs build`.
   


-- 
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]

Reply via email to