开源社区贡献手册

序

不同社区有不同的贡献方式，也有不同的社区文化，这里想做一下记录。

Postgres

邮件投递Patch（非 PR）。
流程：先在 pgsql-hackers 讨论 → 准备Patch（含测试/文档）→ 用邮件提交 → 在 CommitFest 条目中跟进审核。
git format-patch <upstream>..HEAD --cover-letter -v2
git format-patch -1 HEAD --subject-prefix='PATCH'

CommitFest 跟进

在 CommitFest 平台登记条目（commitfest.postgresql.org）
填写主题、分组、指向邮件的 Message-ID 或线程链接
状态流转：Needs review → Waiting on Author → Ready for committer → Committed/Returned with feedback
审核期间及时响应评审意见，发送 v2/v3… 补丁，保持同一邮件线程

Patch要点
小而完整：每个补丁做一件清晰的事，包含测试和文档
可回滚、安全：失败路径/错误处理、兼容性与升级行为说明清楚
风格一致：遵循 PostgreSQL Coding Conventions 与 pgindent 规范
性能与风险：若影响性能/锁/并发，提供基线与对比；说明边界与降级策略