DISCUSS: Agree a type-hint policy
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- ドキュメント
- 明瞭さ
- 説明が足りない
- 活発さ
- 静か
- 技術スタック
- python
調査の方向性
まず、コントリビューションガイド、アノテーションが付けられたモジュール game_converters.py、howson_lcp.py、polymatrix_game.py、および PR #576 を確認してください。この issue では、アノテーションのポリシーと PR の扱いについてチームで決定する必要があります。コントリビューションガイドに決定内容がまとめられ、具体的なフォローアップが特定されれば完了です。
索引モデルが issue の本文から書いたものです。
説明
The decision needed
Type annotations cover 9 of 481 functions (1.9%), all in three recently added game_theory modules (game_converters.py, howson_lcp.py, polymatrix_game.py). New code annotates; old code does not; nothing records which is intended.
The decision has been pending in concrete form for a long time: PR #576 ("Annotate normal_form_game.py") has been open more than five years. Resolving the policy resolves the PR, one way or the other.
Questions for the team
- Are annotations expected on new code, welcome but optional, or out of scope?
- If expected, is the target the public API surface only, or everything?
- Numba-jitted functions have real constraints — annotations on
@njitfunctions are informational and can mislead about what numba actually accepts. Does the policy carve them out? - Is a
py.typedmarker and a checkedmypyjob on the roadmap, or would annotations be documentation-only? - Does PR #576 merge, get rebased, or get closed?
Whatever is decided, write it in the contributing guide. The current state is not a wrong decision; it is an unmade one, and the cost falls on contributors who cannot tell whether adding hints will be welcomed or reverted. Close this thread with a summarised decision and spawn concrete follow-ups.
From the July 2026 technical-debt audit (AI-assisted; claims verified against 28d4b3b on 2026-07-25).
- 主要言語
- Python
- スター
- 2.4k
- フォーク
- 2.3k
- 平均マージ
- 5日 19時間
- マージ済み PR（30日）
- 8
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
QuantEcon/QuantEcon.py のほかの issue
-
documentation
難易度 1/5 1時間未満 初心者へのやさしさ 92/100
QuantEcon/QuantEcon.py#988 ·
メンテナーはふだん 1 日以内に返信
-
BUG: solve_discrete_riccati_system returns NaN instead of raising when the iteration overflows対応中かも @mayuriphad が 1 日前に担当しました。 オープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
QuantEcon/QuantEcon.py#986 ·
メンテナーはふだん 1 日以内に返信
-
DOC: Document the commit-message prefix convention対応中かも @nicolasdmolina が 37 日前に担当しました。 オープンdocumentation good first issue low-priority
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
QuantEcon/QuantEcon.py#902 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
documentation security
難易度 2/5 1〜2日 初心者へのやさしさ 68/100
QuantEcon/QuantEcon.py#891 ·
メンテナーはふだん 1 日以内に返信
-
bug documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 45/100
QuantEcon/QuantEcon.py#987 ·
メンテナーはふだん 1 日以内に返信
QuantEcon/QuantEcon.py の issue をすべて見る
似ている issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
Graphify-Labs/graphify#4524 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
topoteretes/cognee#5982 ·
メンテナーはふだん 1 日以内に返信
-
Patches of derivations with `__structuredAttrs` are ignored対応中かも @KiaraGrouwstra が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 81/100
nix-community/vulnix#184 ·
-
New Internshipオープンnew_internship
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
aws-samples/sample-per-model-bedrock#295 ·
メンテナーはふだん 1 日以内に返信