Consider a normative references chapter
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 35/100
- Issue 类型
- 文档
- 描述清晰度
- 需要澄清
- 活跃度
- 冷清
调研方向
首先审阅 identifiers、unwinding、inline assembly 和 ABI 章节，以及其中目前提到的标准和文档。确定哪些 Unicode、C、C++、LLVM、ABI 及其他引用足够具体，适合纳入，并判断维护成本是否合理。完成的标准是记录已达成一致的规范性引用范围，或记录不应添加该章节的原因。
由索引模型根据 Issue 内容生成。
描述
ISO standards have a mandatory Normative References chapter. I considered this a lot in the past, but never got around to adding it. There's not a lot that would necessarily be listed, but if we really want to be precise about how things work, it would cover those bases.
Some examples:
- The specific Unicode standard is already documented in the identifiers chapter, but could/should also be included in the references.
- The specific C specification we are working against. For example, things like C-variadics refer to specific C features without specifying which C standard.
- Unwinding refers to C++ without referring to anything specific (I'm not sure if this necessary, see this thread).
- Inline assembly refers to LLVM, and using its syntax, without specifying which LLVM.
- The ABI list refers to specific documentation and standards.
I don't know what exactly makes sense to include. And I'm not sure how valuable it would be, and would it be worth the maintenance cost.
- 主要语言
- Rust
- 星标
- 1.6k
- 派生
- 614
- 平均合并
- 20 小时 25 分钟
- 30 天内合并 PR
- 9
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
rust-lang/reference 的其他 Issue
-
A-const-eval A-undefined-behavior
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
rust-lang/reference#2266 · 1 条评论 ·
维护者通常 1 天内回复
-
A-resolve
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
A-coercions
难度 2/5 1-3 小时 新手友好度 65/100
rust-lang/reference#2094 · 1 条评论 ·
维护者通常 1 天内回复
查看 rust-lang/reference 的全部 Issue
相似的 Issue
-
area: supply-chain
难度 1/5 1 小时以内 新手友好度 73/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 67/100
-
难度 1/5 1-3 小时 新手友好度 67/100
OpenCarControls/firmware#35 ·
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复