Asgard社区贡献指南：如何参与开源项目开发
项目地址: https://gitcode.com/gh_mirrors/as/asgard Asgard是一个用于在Amazon Web Services（AWS）中进行应用部署和云管理的Web界面，虽然Netflix已将其 deprecated 并转而使用Spinnaker，但作为开源项目，它仍需要社区的积极参与来持续发展和完善。本指南将为你详细介绍如何参与Asgard开源项目的开发，成为贡献者的一员。
贡献的多种方式 🚀
参与Asgard社区贡献并非只有代码提交一种方式，还有许多其他途径可以为项目添砖加瓦：
- 分享与推广：通过交流、发推文、写博客、做演讲、提交演讲内容、编写教程或文章（甚至书籍！）、分享成功案例，将你的项目/公司添加到Who is Using Asgard等方式来传播Asgard的相关信息。
- 帮助他人：积极参与Asgard Users Google Group，为其他用户解答疑问。
- 完善文档：改进和扩展项目的wiki。
- 修复问题：解决issue tracker中列出的未解决问题。
- 提出新功能：提议、讨论并实现新的功能。
- 参与线上活动：参加Asgard Show on Google Hangouts。
- 加入团队：加入Netflix，全职参与Asgard的开发工作！
- 其他形式：用其他意想不到的方式为项目做出贡献！
所有形式的贡献都非常值得赞赏。
有效的沟通方式 🗣️
良好的沟通至关重要。我们始终乐于倾听、反思和讨论。你可以通过issue tracker或我们的用户论坛与我们取得联系，选择你认为最合适的沟通方式即可。
代码和文档贡献步骤 🔧
要贡献代码或文档，请向GitHub仓库提交拉取请求。
熟悉代码库和贡献流程的一个好方法是在issue tracker中寻找并解决那些容易解决的问题。在进行更具挑战性的贡献之前，请通过上述沟通方式与我们快速取得联系。这将有助于确保你的贡献与Asgard的整体方向和目标保持一致，并让我们有机会在设计和实现方面提供指导。
我们非常感谢你的努力，希望避免出现贡献需要大量返工（无论是你还是我们）、长时间排队等待，或者根本无法被接受的情况！
提出新功能建议 💡
如果你想实现一个新功能，请在发送拉取请求之前提出一个issue，以便对该功能进行讨论。这是为了避免你花费宝贵的时间开发项目开发人员不愿意接受的功能。
修复漏洞 🐛
如果你想修复一个漏洞，请在发送拉取请求之前提出一个issue，以便进行讨论。如果修复是微不足道或没有争议的，通常不需要这样做。
编码风格指南 📝
在贡献代码时，请遵守以下一般准则：
- 所有内容都需要进行测试。
- 所有源文件必须有适当的ASLv2许可证头。
- Groovy、Java和JavaScript使用4个空格缩进，GSP和HTML使用2个空格缩进。如果不确定，让你的缩进与附近的代码保持一致，并且不要使用制表符。为了确保无误，你可能还需要查看Groovy代码风格指南[http://groovy.codehaus.org/Groovy+style+and+language+feature+guidelines+for+Java+developers]。
- 请运行Asgard的CodeNarc任务（
grails codenarc）。 - 为所有类和公共方法添加Groovydoc注释。
- 再次强调，所有内容都需要进行测试（见第1点）。
兼容性要求 🔄
Asgard支持JRE 1.6及更高版本。因此，不能使用仅在Java 1.7或更高版本中可用的语言特性和API。此规则的例外情况需要事先讨论。用户可见行为的更改也是如此。
测试规范 🧪
所有测试都使用Spock编写。
参与项目的准备工作 📋
克隆仓库
首先，你需要将项目仓库克隆到本地，仓库地址是 https://gitcode.com/gh_mirrors/as/asgard 。
了解项目结构
项目结构中包含多个重要的目录和文件，例如：
- 应用相关的代码在
app/目录下，其中app/scripts/controllers/deployment/目录下有部署相关的控制器代码，如detail.js和new.js。 - 视图文件位于
app/views/目录，如部署相关的视图在app/views/deployment/下。 - 测试相关的代码在
test/目录，包括单元测试和规格测试等。
相关资源
项目中还有一些有助于开发的资源，如Tango调色板图片，它可以帮助你在开发界面时选择合适的颜色。
通过以上步骤和指南，相信你已经对如何参与Asgard开源项目的开发有了清晰的了解。期待你的加入，让我们一起为Asgard的发展贡献力量！
The Asgard Team
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
