内容

参与

如果您想参与 Apache Tomcat® 的开发和支持，您可以通过多种方式做出贡献。第一步是 加入邮件列表。以下是一些您可以提供帮助的领域：

  • 回答在 邮件列表 上发布的问题。
  • 为 常见问题解答 或 维基 做出贡献。
  • 为网站或 Apache Tomcat 用户文档贡献其他文档补丁。
  • 调查已报告的错误，并在适当的情况下提供补丁。
  • 帮助 翻译 Apache Tomcat 中的消息和 Web 应用程序到其他语言。
  • 帮助开发 Servlet 和 JSP 规范的下一个版本。
您还应该阅读 Apache 的工作原理。

贡献更改

如果您想开始贡献更改，第一步是签出源代码并构建 Apache Tomcat。有关详细说明，请参阅您要使用的 Apache Tomcat 版本的文档区域中的“构建”页面。

在做出贡献时，请尽量减少不必要的或无关的更改（例如格式）。Apache Tomcat 有许多贡献者，能够在整个源代码历史记录中进行差异比较非常重要。进行小的渐进式更改并尊重现有源代码的约定将极大地提高您的补丁被接受的可能性。

一旦您成功启动并运行 Apache Tomcat，那么 Apache 贡献者技术指南 是学习如何创建和提交补丁的好地方。

编码规范

Apache Tomcat 的编码规范定义较为宽松，但以下指南将非常有用。
  • 使用空格进行缩进，而不是制表符。
  • Java 源代码行宽为 120 个字符，文档源代码（.txt、.xml）行宽为 80 个字符。
  • Java 源代码：`{` 在行尾，4 个空格缩进。
  • XML 源代码：2 个空格缩进。