Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

copy.replace() is annotated as "versionadded: 3.13", butobject.__replace__ isn't #134559

Open
Labels
docsDocumentation in the Doc dir
@ferdnyc

Description

@ferdnyc

Documentation

In thecopy module documentation, the functioncopy.replace() has a.. versionadded:: annotation marking it as new in Python 3.13.

But the relatedobject.__replace__ dunder method — which is documentedmuuuuuch farther down the page, near the very end — has no such annotation.

IMHO the two are too far apart and separated by too much completely unrelated documentation, for the annotation fromcopy.replace() to be implicitly applicable toobject.__replace__ as well.

Module-level organization of content

To be perfectly honest, I'm not sure it makes sense forcopy.replace() to eventually be documentedso far from where it's initially introduced. Especially considering how brief that documentation actually is, the separation may do more harm than good.

No other module in the "Data Types" section starts with an "Interface summary:" like the one in thecopy documentation. The most similar doc is theenum module's, which has a §Module Contents at the start. But there inline version annotations are skipped to keep the TOC concise, instead they're collected down below the list itself. Relevant annotations are also included in the detailed documentation sections that follow.

The organization of thecopy docs is sort of... well, there's muchless organization there, than in the documentation for other modules. (Probably attributable to both the age and extremely short length of thecopy documentation.)

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


      [8]ページ先頭

      ©2009-2025 Movatter.jp