Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Bug]: docs links sometimes have incorrect extension

Open
#881 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
38/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Domain
documentation

Research direction

Start at the linked FastAPI documentation page and inspect the “see starlette integration” link, then compare it with the side-menu destination. Done when that link reaches the same Starlette page as the side menu without a 404.

Written by the indexing model from the issue text.

Description

area/documentation kind/bug kind/bug/confirmed
Actual Behavior

If I visit https://openapi-core.readthedocs.io/en/latest/integrations/fastapi.html and click "see starlette integration"
Screenshot 2024-07-31 at 07 12 11
Then I get a 404, because the extension is .rst
https://openapi-core.readthedocs.io/en/latest/integrations/starlette.rst

Expected Behavior

When I use the side-menu, I can navigate to the same page.
Additionally on the 404 page, I don't have a menu, so I have to use the browser back-button, or delete the path, before navigating to https://openapi-core.readthedocs.io/en/latest/integrations/starlette.html

Steps to Reproduce

visit https://openapi-core.readthedocs.io/en/latest/integrations/fastapi.html
scroll to the bottom of the main content page.
click on the "see starlette integration" link
404 😢

OpenAPI Core Version

main

OpenAPI Core Integration

docs

Affected Area(s)

docs

References

this is your documentation page https://openapi-core.readthedocs.io/en/latest/integrations/fastapi.html

Anything else we need to know?

No thanks, but this has been quite a journey to fill out as a user.

Would you like to implement a fix?

No

Dominant language
Python
Stars
368
Forks
140
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from python-openapi/openapi-core

All issues in python-openapi/openapi-core

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.