如何贡献
Zephyr项目社区由一些较小的社区组成,每个社区都有自己的交流重点,需求和方法。
交流准则
一般准则
友善:对所有的成员友善和礼貌
尊重他人:不能有地域,种族和其它歧视行为
文明用语:保持语言文明(不要骂人)
乐于助人:对新人有耐心,主动回答问题
保持冷静:文字说明容易被曲解,因此允许其他人进行质疑,不要因为质疑和激动
遵守法律:确认你发布的内容遵守法律
贡献前必看
在贡献前,请查询邮件列表,bug列表,文档内是否有你的问题。在发布问题前如果做了对应的准备工作,也许会得到更好的答案。
邮件列表指南
保持简洁
你的邮件内容会出现在数千个邮箱中
- 邮件内容竟可能简短
- 避免包含全部log(替代方案有截取相关的log内容, 将log放到网站上或者pastebin)
- 不要引用前文太多内容(只引用最近相关的信息)
使用适当的发布风格
不使用html和富文本:为避免被当做垃圾邮件,将邮件设置为纯文本发生
回复不置顶: 置顶回复将增加摘要大小,并且会导致内容不连贯
交错式回复:将回复内容放到引用内容之下,但引用的内容需要精简,删除不相干的文字
使用链接:不要赞同整篇文章,提供文章的摘要和链接。
不添加附件:将附件上传到网站,在邮件里面提供文件链接
不要切换讨论主题
新问题发布新主题,不要在原有主题上展开。避免造成混淆
单一邮件列表
一个问题选择最合适的邮件列表,不要发到多个邮件列表内
发布问题
只有邮件列表订阅者可以发布问题。如果只是想浏览邮件列表,可以让邮箱只收邮件摘要,在网站上阅读邮件内容
提交Bug指南
指南
有耐心:当有人提交信息不完善的bug时,请告诉bug提交者需要那些信息,并给他们提出改善提交bug的建议
保持主题:将讨论限定在Bug范围内,不要发散
适度引用:避免完全引用以前的注解,去掉无关的内容,只引用有用的
不要滥用权限 滥用权限将被取消权限,例如:reopen一个被关闭的bug
发现bug如何做
首先搜索:为避免重复提交,先搜索是否有类似的bug
提问:在邮件列表中询问是否有人遇到类似的问题,以便收集更多的信息或在得到解决方案
提交bug报告:提供Bug重现方法和bug发生的详细信息
跟踪进度:跟踪解决状态和社区的反馈
提供解决方案:如果知道如何fix或workaroud,提供给社区
违反规则处理方法
好事不过三原则,当有人违反规则时:
第一次:公告提醒所违反的指南内容。
第二次:私信警告违规行为可能导致帐号禁用和删除
第三次:根据违规情况禁用帐号或删除帐号
注意
- 垃圾邮件不会三次警告,只要出现垃圾邮件就禁止帐号
- 6个月消除违规记录
- 很小的违规行为不纳入三次警告,只是通过教育来解决
- 极端的违规行为(破坏性的,非法的)不进行3次警告,立即处理