[Bug]: docs links sometimes have incorrect extension

Đang mở
#881 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
38/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Python
Star
368
Fork
140
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của python-openapi/openapi-core

Tất cả issue của python-openapi/openapi-core

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.