了解 Vyper 上游社区对 issue、VIP、Pull Request 和测试补充的基本要求。
这一页说明了如何为 Vyper 项目贡献代码、文档、讨论和问题报告。 如果你准备参与上游社区,这一页给出了最基础的协作规则。
官方明确表示,以下几类贡献都很有价值:
如果你刚接触 Vyper,先熟悉安装流程、编译流程和合约编写方式,会更容易进入贡献状态。
如果你要提出结构性改进,官方建议使用 Vyper Improvement Proposal,也就是 VIP。 参考入口是官方仓库里的 VIP 模板:
这类提案适合放语言设计、编译器行为或工作流层面的改动,不适合拿来报普通 bug。
提交 issue 时,官方建议至少包含以下信息:
能把问题最小化成一个可复现示例会非常有帮助,它不仅方便维护者定位问题,也经常能帮助你自己发现误解。
问题入口:
提交代码贡献时,参考文档给出的要求包括:
master 分支 fork 出自己的分支。master,优先使用 git rebase,避免 git merge。pytest 测试,并放到 tests/ 下。#compiler-dev 频道沟通。官方文档还专门强调了 commit message 质量,并引用了这篇经典文章:
如果使用上游仓库自带格式化脚本,原始流程是:
python fmt_commit_msg.py commitmsg.txt 原地格式化。维护者在 squash merge 时会复用这段信息。
本页目录