发布指南
发布指南一般建议张贴在Bioconductor帮助网站。
修订日期:2018年5月9日
为什么?
格式良好的问题能得到更好的回答，还能节省大家的时间。
请记住，支持网站上的助手是志愿者，他们通常非常了解Bioconductor但他不知道你已经做了什么，也不知道你正在尝试做什么。下面的要点旨在帮助你提供足够的信息，以便有经验的人可以在不要求更多信息的情况下提供有用的答案。
(回到顶部］
要点
使用最新的Bioconductorbob 体育平台下载 。确保你的包裹完好无损最新的。
张贴你所有的R代码。
中出现的任何错误或警告消息的副本R。
如果你的问题涉及实验数据，包括一个例子样本水平的协变量数据(每个样本一行，每个协变量一列)。如果它有助于回答你的技术问题，并且可以分享，解释你实验背后的动机。
始终粘贴的输出
sessionInfo ()在你文章的最后。如果可能的话，提供一个最小的、独立的例子，让其他人可以剪切粘贴到新的例子中R会话重现您的问题。
如果示例产生错误，则提供的输出
回溯()错误发生后。
(回到顶部］
与包维护者沟通
用适当的软件包名称标记您的文章。放置正确的标记很重要，因为这会触发系统自动向包维护者发送电子邮件。大写不重要，但拼写对包标签来说很重要。
不要直接给包维护人员发邮件。尽可能把所有的对话都保存在支持网站上，除非对方指示，否则不要回复到电子邮件。有些包维护者为错误报告提供了另一个URL，在BugReports在包的登录页面。
为什么?由于支持站点是公共的并且可搜索的，因此它作为一个存档，为可能面临类似错误或问题的其他用户提供了好处。
(回到顶部］
在发布之前
阅读有问题的包的小插图
browseVignettes(“somepkg”)。搜索小插图文本中与你的问题相关的部分。阅读相关的R文档。如果你在功能上有问题
somefunc ()的相关章节somefunc ?，包括关于函数参数和函数输出的部分。在支持网站上搜索类似的帖子。搜索支持网站的最佳方式是使用谷歌首先
网站:support.bioconductor.org后面跟着一个空格和一组关键字和包名。确保你的问题切题。的Bioconductor支持网站主要是为了帮助人们解决使用问题Bioconductor软件关于非生物导体的问题R应该询问包或一般统计信息R-或Stackoverflow。关于生物信息学的问题，但不是关于Bioconductor包裹可以寄到Biostars。
(回到顶部］
作曲
使用一个信息丰富的标题。这将有助于吸引响应者，并帮助其他人在搜索支持网站时。例如，标题行“使用limma的时间课程实验”比“limma”更好。
如果您正在询问如何使用特定函数或包的建议，那么请详细解释您已经阅读了哪些文档，以及为什么这些文档还没有完全回答您的问题。这允许回复者回答您的特定问题，而不是简单地让您参考现有的文档。
如果您的问题是关于包开发，请发送电子邮件到bioc-devel列表;否则，发布到Bioconductor支持网站。
如上所述，用适当的软件包名称标记您的文章。
包含所有输出的代码块。使用开头和结尾的三反标记来指示代码块(
' ' ')．您可以直接从控制台复制和粘贴代码到反勾号之间。的结果总是包含一个代码块
sessionInfo ()。这将显示您正在运行的操作系统平台版本以及R和R/的版本Bioconductor包版本。阅读你的帖子。它是否礼貌且容易理解?记住Bioconductor支持网站上都是志愿者提供的帮助。
还有一个使用markdown编辑器/格式化的有用教程。这可以在在这里
(回到顶部］
回复
使用添加评论按钮，要求对答案进行进一步解释，或回复有关更多信息的请求。
只使用添加答案按钮，如果你是在回答最初的问题。
如果可能的话，写一个能被不同科学背景、技能水平/技能简介的读者理解的答案。尽可能使用简单的英语，让你的答案为最广泛的受众所接受。
在回答问题的时候，可以考虑解释一下你是如何得出这个解决方案的。通过这种方式，你不仅帮助人们解决了他们手头的问题，而且在未来也帮助了他们自己。
粗鲁和人身攻击是不可接受的。
简洁是可以的。但是，考虑一下，对你来说显而易见的信息可能对其他人很有帮助。
提供其他相关线程或网站的url。
(回到顶部］
致谢
本张贴指南已大量改编自R-帮助张贴指南，提出各种意见和建议Bioconductor海报，灵感来自埃里克·史蒂文·雷蒙德关于如何以聪明的方式提问。
