Skip to content

Docs still reference pre-Platforms/ paths and removed files #154753

Description

@ZayanKhan-12

Documentation

The Platforms/ re-organization (gh-146445) moved the Android and Apple build trees to Platforms/Android and Platforms/Apple, and the devguide was updated — but several Doc/ pages still reference the old locations, so their :source: links render as broken GitHub URLs on docs.python.org today:

  • Doc/using/android.rst — five :source: references to Android/... (testbed, README, build.gradle.kts, MainActivity.kt, main_activity.c)
  • Doc/using/ios.rstApple/iOS/README.md (×2), the testbed reference (Apple/iOS/testbed; the shared testbed now lives at Platforms/Apple/testbed), and a shell example invoking python Apple/testbed
  • Doc/using/configure.rst:source:`iOS/README.rst` (moved twice, and the file is Markdown)

Unrelated to the move, a few more references point at files that no longer exist:

  • Doc/extending/extending.rstObjects/pycapsule.c (the implementation is Objects/capsule.c)
  • Doc/library/sys.rstObjects/lnotab_notes.txt (removed in Remove deprecated co_lnotab from CodeType #134690; the locations table is now documented in InternalDocs/code_objects.md)
  • InternalDocs/jit.md — links the gitignored build artifact jit_stencils.h (404 on GitHub)
  • InternalDocs/code_objects.md — an inverted Markdown link, (text)[url], that doesn't render

I have a PR ready for all of these. Note the Platforms/ fixes apply to main only — 3.13/3.14 still have the old tree layout, so those hunks must not be backported.

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    Status
    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions