Ruby-Talk 邮件列表发帖指南
发帖至 ruby-talk 邮件列表时,您应遵循以下指南。
-
始终保持友好、体贴、机智和得体。我们希望这个列表能够包容越来越多的新手、非常年轻的开发者和他们的老师,同时也能满足那些经验丰富的“老手”。:-)
-
保持内容相关且易于理解。尽量使内容简洁明了,但也要包含所有相关信息。
-
通用的格式指南(又称网络礼仪)是常识和礼貌的问题,它们能让第三方更容易地理解(无论是实时还是在浏览归档时)
- 请注意:将先前帖子的引用文本放在您的回复之前,并且有选择性地引用尽可能多的相关内容。
- 使用纯文本;请勿使用 HTML、RTF 或 Word 格式。大多数电子邮件程序都有此选项;如果您的程序没有,请获取一个(免费)程序或使用支持纯文本的网络服务。
- 将文件中的示例作为行内文本包含;请勿使用附件。
-
如果报告问题,请第一次就提供所有相关信息;这里不是“灵通朋友”咨询组。:-)
在适当时,请包含
- 一个(最好是简单的)能重现问题的示例
- 实际的错误消息
- Ruby 版本(
ruby -v) - 操作系统类型和版本(
uname -a) - 用于构建 Ruby 的编译器名称和版本
-
-
使主题行尽可能地信息丰富,以便感兴趣的人会阅读您的帖子,并且不感兴趣的人可以轻松避免。
有用地描述您的帖子的内容。
这样可以
- “如何在 z 上用 y 实现 x?”
- “问题:执行了 x,预期是 y,结果是 z。”
- “BUG:使用模块 y 处理 x 时,z 崩溃了。”
这样不可以
- “请帮忙!!!”
- “新手问题”
- “需要 Ruby 专家告诉我哪里错了”
这些前缀已成为主题行的常见用法
[ANN](用于公告)[BUG](用于 bug 报告)[OT](用于离题内容,如果您非要发离题内容的话)
-
最后,请考虑他人:不要太懒。如果您在寻求信息,请先合理地尝试查找。请酌情查阅 Ruby 主页、Ruby FAQ 和其他文档,使用搜索引擎搜索过去的帖子,等等。
这些指南采纳自 comp.lang.ruby FAQ。