Enforce the use of `deprecated-removed` in docs

オープン

#92,564 2022年5月9日に作成コメント 12 件リアクション 2 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 5/5
見積もり時間: 1週間以上
初心者へのやさしさ: 25/100

issue の種類: ドキュメント
明瞭さ: 説明が足りない
活発さ: 停滞
領域: documentation

調査の方向性

まず、.rst ファイル全体で deprecated:: と deprecated-removed:: の文書化された grep 件数を再実行して確認し、その後 #92308 の関連作業を確認します。Issue のチェックリストは、完了するには削除バージョンを設定し、自動化を検討し、古いディレクティブを非推奨にするかどうかを決定する必要があることを示しています。

索引モデルが issue の本文から書いたものです。

説明

3.10 3.11 3.12 3.9 (EOL) docs type-feature

In the docs we have two directives that can be used to document deprecations: deprecated and deprecated-removed.

I think we should always prefer the latter:

it will make it easier to track and document removals
it will give people a target, so they can plan around it

Even if the removal version gets postponed, it's better to postpone than to say that something is deprecated and then just remove it at an unspecified time in the future.

Currently deprecated is more commonly used:

$ grep -r 'deprecated::' --include=*.rst | wc -l
226
$ grep -r 'deprecated-removed::' --include=*.rst | wc -l
30

set removal version for deprecated features using deprecated-removed
automate the documentation of deprecations (see also #92308)
possibly deprecate the deprecated directive and replace it with deprecated-removed

主要言語: Python
スター: 77.2k
フォーク: 36k
平均マージ: 1日 9時間
マージ済み PR（30日）: 558

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

python/cpython のほかの issue

docs: Zipfile contains a 13-years outdated warning regarding path sanitization オープン

docs pending

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

python/cpython#157339 · コメント 10 件 · 2026年9月11日に作成
pydoc HTML output is not responsive and has no viewport meta in released versions オープン

stdlib type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

python/cpython#155601 · コメント 2 件 · 2026年8月12日に作成
`zipfile.ZipFile.writestr()` raises `AttributeError` instead of accepting `os.PathLike` objects (e.g. `pathlib.Path`) オープン

stdlib type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

python/cpython#153771 · コメント 5 件 · 2026年7月15日に作成
BOLT-WARNING: specifying numeric value "1" for option -icf is deprecated オープン

build type-bug

難易度 2/5 1〜3時間初心者へのやさしさ 76/100

python/cpython#149708 · コメント 1 件 · 2026年5月12日に作成
Expose message ID list from `ReferencesHeader` オープン

stdlib topic-email type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

python/cpython#148797 · コメント 3 件 · 2026年4月20日に作成

python/cpython の issue をすべて見る

似ている issue

[Bug]: redact_sensitive_text does not recognise Discord bot tokens オープン

area/auth bug comp/agent P3 platform/discord type/security

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

NousResearch/hermes-agent#117848 · 2026年9月21日に作成
[Bug]: notebooks/06_visualization_quickstart.ipynb fails: SHAPVisualizer.plot_waterfall raises IndexError オープン

難易度 2/5 1〜3時間初心者へのやさしさ 74/100

bancolombia/sentinel#23 · 2026年9月20日に作成
test md オープン

CI

難易度 2/5 1〜3時間初心者へのやさしさ 74/100

sympy/sympy#30547 · コメント 1 件 · 2026年9月20日に作成
quickjs: support `timeout=None` (no per-call deadline) in `CodeInterpreterMiddleware` オープン

integration:quickjs org:external priority:backlog topic:code-interpreter topic:middleware type:feature

難易度 2/5 1〜3時間初心者へのやさしさ 74/100

langchain-ai/deepagents#6450 · 2026年9月20日に作成
OpenAISamplingHandler drops ToolResultContent when a user message's list content also carries text/image blocks オープン

bug client

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

PrefectHQ/fastmcp#5182 · コメント 1 件 · 2026年9月20日に作成

Python の issue をもっと見る