Ruby-Talk 邮件列表发帖指南

发帖至 ruby-talk 邮件列表时,您应遵循以下指南。

  1. 始终保持友好、体贴、机智和得体。我们希望这个列表能够包容越来越多的新手、非常年轻的开发者和他们的老师,同时也能满足那些经验丰富的“老手”。:-)

  2. 保持内容相关且易于理解。尽量使内容简洁明了,但也要包含所有相关信息。

    1. 通用的格式指南(又称网络礼仪)是常识和礼貌的问题,它们能让第三方更容易地理解(无论是实时还是在浏览归档时)

      • 请注意:将先前帖子的引用文本放在您的回复之前,并且有选择性地引用尽可能多的相关内容。
      • 使用纯文本;请勿使用 HTML、RTF 或 Word 格式。大多数电子邮件程序都有此选项;如果您的程序没有,请获取一个(免费)程序或使用支持纯文本的网络服务。
      • 将文件中的示例作为行内文本包含;请勿使用附件。
    2. 如果报告问题,请第一次就提供所有相关信息;这里不是“灵通朋友”咨询组。:-)

      在适当时,请包含

      • 一个(最好是简单的)能重现问题的示例
      • 实际的错误消息
      • Ruby 版本(ruby -v
      • 操作系统类型和版本(uname -a
      • 用于构建 Ruby 的编译器名称和版本
  3. 使主题行尽可能地信息丰富,以便感兴趣的人会阅读您的帖子,并且不感兴趣的人可以轻松避免。

    有用地描述您的帖子的内容。

    这样可以

    • “如何在 z 上用 y 实现 x?”
    • “问题:执行了 x,预期是 y,结果是 z。”
    • “BUG:使用模块 y 处理 x 时,z 崩溃了。”

    这样不可以

    • “请帮忙!!!”
    • “新手问题”
    • “需要 Ruby 专家告诉我哪里错了”

    这些前缀已成为主题行的常见用法

    • [ANN] (用于公告)
    • [BUG] (用于 bug 报告)
    • [OT] (用于离题内容,如果您非要发离题内容的话)
  4. 最后,请考虑他人:不要太懒。如果您在寻求信息,请先合理地尝试查找。请酌情查阅 Ruby 主页Ruby FAQ 和其他文档,使用搜索引擎搜索过去的帖子,等等。

这些指南采纳自 comp.lang.ruby FAQ