Update reference/generics.html with PEP695 type parameter syntax
未关闭
适合新手
还没有人认领这个 Issue。
topic: documentation
- 主要语言
- Python
- 星标
- 1.8k
- 派生
- 302
- 平均合并
- 23 小时
- 30 天内合并 PR
- 8
描述
The typing documentation for generics is somewhat inconsistent in the use of new syntax:
-
Generics — typing documentation (https://typing.python.org/en/latest/reference/generics.html) doesn’t include the new syntax class Foo[T] at all
-
Generics — typing documentation (https://typing.python.org/en/latest/spec/generics.html) does, and mentions PEP695
Are there any plans on updating reference/generics.html? It is a bit confusing for someone who is using Python 3.12 or newer to see out-of-date information.
贡献指南
这个仓库没有索引到贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从 reference/generics.html 开始,将其中关于泛型的指南与 spec/generics.html 进行比较,尤其关注 PEP 695 的材料和 class Foo[T] 语法。更新参考页面,使其对泛型语法的处理与规范一致,然后检查已渲染的文档,确认示例和措辞相匹配。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- python
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 活跃度
- 冷清
- 描述清晰度
- 描述清楚
- 新手友好度
- 76/100