所有功能会使用 Github Issues 追踪和讨 论。如果有新功能的建议,也可以 建立新的 Issue,使用标题简要描述 要做什么,并在正文中补充详细信息方便大家讨论。
代码贡献采用 Pull Request,如果还不熟悉流程,可以参考 Wiki
如何贡献代码 和
#41 中的讨论。请在提交的 Pull
Request 中使用 #id
提及相关的 Issues。
Pull Request 中的代码更改需要测试代码覆盖,以保证这些更改在后续时不被破坏。测试分成三部分。
- 集成测试。基于 rspec 和 capybara。详
细参考 capistrano 的文档。测试文件放到 spec/features 下。通过
rspec spec/features
运行。 - 单元测试,使用 rspec。通过
rake rspec
运行(也会运行集成测试)。 - Javascript 测试,使用 jasmine-rails。测试文件
放到 spec/javascripts 下。通过
rake spec:javascript
运行 (需要安装 PhantomJS,或者打开 http://localhost:3000/specs 查看测试结果 (替换localhost:3000
为你实际 Rails server 的地址)。
新功能,改变网站行为,或者对后续开发有影响的改动需要在 Pull Request 中更新 CHANGELOG。
有任何问题都可以在 Issues 中提出。
你可以通过在本地部署或者访问 http://19wu.com 来试用功能,通过 Github Issues 提交 建议或者找到的 Bug。为了方便 快速确认和定位,Bug 应该有详细的环境描述和重现步骤。可以参考 已经提交 的 Bugs ,或者使用下面的模板:
注册成功后无法登录
- 版本:0.0.1
- 浏览器:Google Chrome 23
- 操作系统:Linux
重现步骤:
- 在首页注册新用户。
- 成功后使用用户名和密码登录。
- 提示用户不存在,无法登录。见截图。
Bug 修复同样使用 Pull Request 贡献,并在 CHANGELOG 中记录。
-
可以参考如何贡献代码,翻 译 config/locales 下的文件并提交 Pull Request。
-
也可以在线浏览 config/locales 并把翻译的文件通过 Issue 提交。
社区通过 Wiki 维护各种文档。也可以在 Issues 中搜索以前的讨论。
Wiki 目录是开放编辑的,欢迎更正错误,并添加新的内容。
- 向身边的朋友介绍 19wu
- 通过博客,微博介绍
- 使用 19wu 发起活动