Skip to content

DEVELOPMENT.md referenced in AGENTS.md despite not existing #8356

Closed

Description

@ThomasJRyan

- Read the [development guide](/DEVELOPMENT.md) for detailed setup instructions

I'd raise a PR to remove or change the line myself, but I was just passing by when I noticed this and I'm not certain what the intent is meant to be

Activity

  1. leehanjeong commented on Jul 30, 2026

    @leehanjeong
    Contributor

    There are two more DEVELOPMENT.md references besides L304, and they don't all have the same fix.

    AGENTS.md Reference Resolvable?
    L268 [DEVELOPMENT.md](DEVELOPMENT.md#testing-on-linux-from-macos) Yes. The section is now CONTRIBUTING.md § "Testing on Linux from macOS"
    L304 [development guide](/DEVELOPMENT.md) Yes. CONTRIBUTING.md
    L272 See DEVELOPMENT.md "CPython Version Upgrade Checklist" section. No. No such section has ever existed

    L268 and L304 are fallout from fc637a155 (#7914), which renamed DEVELOPMENT.md to CONTRIBUTING.md without updating AGENTS.md. Repointing them is enough.

    L272 was introduced already broken in 7a516c44c (#6728). Grepping every revision in history finds "CPython Version Upgrade Checklist" only in AGENTS.md and its predecessor .github/copilot-instructions.md, never in DEVELOPMENT.md. It is not in the wiki either. So the section was never written, and today this is a heading with no body:

    ### Building venvlauncher (Windows)
    
    See DEVELOPMENT.md "CPython Version Upgrade Checklist" section.

    Fixing that one needs the actual build steps written, or the heading removed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions