zephyr贡献规则

Creative Commons
本作品采用知识共享署名

说明

如何贡献

Zephyr项目社区由一些较小的社区组成,每个社区都有自己的交流重点,需求和方法。

交流准则

一般准则

友善:对所有的成员友善和礼貌
尊重他人:不能有地域,种族和其它歧视行为
文明用语:保持语言文明(不要骂人)
乐于助人:对新人有耐心,主动回答问题
保持冷静:文字说明容易被曲解,因此允许其他人进行质疑,不要因为质疑和激动
遵守法律:确认你发布的内容遵守法律

贡献前必看

在贡献前,请查询邮件列表,bug列表,文档内是否有你的问题。在发布问题前如果做了对应的准备工作,也许会得到更好的答案。

邮件列表指南

保持简洁

你的邮件内容会出现在数千个邮箱中

  • 邮件内容竟可能简短
  • 避免包含全部log(替代方案有截取相关的log内容, 将log放到网站上或者pastebin)
  • 不要引用前文太多内容(只引用最近相关的信息)

使用适当的发布风格

不使用html和富文本:为避免被当做垃圾邮件,将邮件设置为纯文本发生
回复不置顶: 置顶回复将增加摘要大小,并且会导致内容不连贯
交错式回复:将回复内容放到引用内容之下,但引用的内容需要精简,删除不相干的文字
使用链接:不要赞同整篇文章,提供文章的摘要和链接。
不添加附件:将附件上传到网站,在邮件里面提供文件链接

不要切换讨论主题

新问题发布新主题,不要在原有主题上展开。避免造成混淆

单一邮件列表

一个问题选择最合适的邮件列表,不要发到多个邮件列表内

发布问题

只有邮件列表订阅者可以发布问题。如果只是想浏览邮件列表,可以让邮箱只收邮件摘要,在网站上阅读邮件内容

提交Bug指南

指南

有耐心:当有人提交信息不完善的bug时,请告诉bug提交者需要那些信息,并给他们提出改善提交bug的建议
保持主题:将讨论限定在Bug范围内,不要发散
适度引用:避免完全引用以前的注解,去掉无关的内容,只引用有用的
不要滥用权限 滥用权限将被取消权限,例如:reopen一个被关闭的bug

发现bug如何做

首先搜索:为避免重复提交,先搜索是否有类似的bug
提问:在邮件列表中询问是否有人遇到类似的问题,以便收集更多的信息或在得到解决方案
提交bug报告:提供Bug重现方法和bug发生的详细信息
跟踪进度:跟踪解决状态和社区的反馈
提供解决方案:如果知道如何fix或workaroud,提供给社区

违反规则处理方法

好事不过三原则,当有人违反规则时:
第一次:公告提醒所违反的指南内容。
第二次:私信警告违规行为可能导致帐号禁用和删除
第三次:根据违规情况禁用帐号或删除帐号

注意

  • 垃圾邮件不会三次警告,只要出现垃圾邮件就禁止帐号
  • 6个月消除违规记录
  • 很小的违规行为不纳入三次警告,只是通过教育来解决
  • 极端的违规行为(破坏性的,非法的)不进行3次警告,立即处理

原文参考

https://www.zephyrproject.org/developers/how-to-contribute/