开发

Angie 是一个开源项目, 欢迎所有贡献者。

源代码

您可以从我们的公共仓库克隆 Angie 源代码: Mercurial, Git。

编码风格

您的更改应与 Angie 其余代码保持一致; 编码约定 是一个很好的起点。

小技巧

如有疑问,请检查附近的代码以遵循其风格, 或者直接在代码库中搜索以获取灵感。

提交消息

从历史上看,提交日志使用英语维护。

以一行总结所做的工作开始。 它可以有一个前缀,提交日志将其用于受影响的代码部分。 总结最多可以有 67 个字符, 后面可以跟一个空行和更多详细信息。

一个好的消息会说明是什么导致了更改、对此做了什么, 以及现在的情况如何:

API: bad things removed, good things added.

As explained elsewhere[1], the original API was bad because stuff;
this change was introduced to improve that aspect locally.

Levels of goodness have been implemented to mitigate the badness;
this is now the preferred way to work.  Also, the badness is gone.

[1] https://example.com

可能会被忽略的细节:

• 总结以句号结尾,并以大写字母开头。

• 如果使用前缀,则后面跟小写字母。

• 双空格分隔单行内的句子。

最终检查

• 尽最大努力验证更改在 所有 目标平台上都能正常工作。

• 对于每个平台,运行测试套件以确保没有回归:

  $ cd tests
  $ prove .
  

  详细信息请参阅 tests/README 文件。

• 确保您对 法律条款 感到满意。

提交贡献

要提交补丁,请在我们的 GitHub 镜像 上创建拉取请求。

如有问题和建议,请通过 GitHub Issues 联系开发人员。