摘要
本文档主题涵盖了如何在 Discourse 中撰写功能请求：分步指南。
第一步：开始之前
您有一个很棒的 Discourse 功能想法？太棒了！以下是如何有效地与团队和社区分享您的想法。在提交功能请求之前，请花点时间搜索现有讨论，看看您的想法是否已被提出或实现。您可以通过以下几种方式进行操作：
- 查找 Feature 类别
- 点击页面右上角的
图标，打开 搜索。您可以使用高级过滤器按类别和标签进行筛选。 - 查看带有 pr-welcome 标签的主题 - PR 是 GitHub 上的拉取请求 - 开发者将新代码引入项目的一种方式。
- 查看带有 completed 标签的主题
- 查找 Plugin 类别
如果您的功能建议已列出，您可以支持它，方法是为其投票以使其请求更突出，点赞它，并回复其他想法或用例，以进一步传达其有用性，说明为什么应该添加该功能。
找不到您想法的任何提及？您可以创建一个功能请求。
第二步：基础知识
标题
主题标题很重要，既要信息丰富，又不能太长。一眼就能轻松识别请求的范围。
类别
创建新主题时，请选择 Feature 类别。
标签
标签用于对功能进行分组和分类，因此，为了保持请求的条理清晰，为主题添加适当的标签对跟踪目的非常有帮助。例如，与 chat 插件相关的所有内容都归为一个标签。
第三步：撰写您的请求
撰写一个好的功能请求很重要，它可以帮助 Discourse 团队快速识别可以改进的领域。
请记住，在创建功能请求时，您是在推销您的想法，并说服人们您的功能想法是有根据的。解释您为什么希望将您的功能添加到社区、您自己以及团队。
在主题正文中，简洁地陈述您请求的功能。要具体和描述性，避免含糊不清或开放式。
提供背景和解释
为您的功能请求提供背景和解释。
- 清晰描述您请求的功能
- 包括您当前遇到的问题或用例，以及您的功能将如何解决它
- 您进行的任何相关背景信息或研究
提供示例和屏幕截图（可选）
如果适用，请提供示例、模型或屏幕截图，以帮助说明您的功能请求，以便其他人可以轻松地可视化您的想法。
与社区互动
创建功能请求后，通过回复问题和反馈与社区成员互动。这将有助于提高您的请求被考虑的机会。
接下来会发生什么
提交功能请求后，它将由社区和 Discourse 团队进行审查。您可以期待：
- 社区的反馈和讨论
- 来自 Discourse 员工的回复，表明您的请求是否可行并正在考虑中
- 在未来的更新中可能实现您的功能请求
希望确保您的功能得以实现？
在某些情况下，功能请求可能不适合核心。您可以 阅读功能决策是如何做出的。如果您无法自己开发该功能，仍然有办法增加其实现的机会。
成为 discourse.org 客户
如果您想通过我们托管的网站来资助开发 - 我们始终在开发时间表中优先考虑客户请求 - 这是加快实现速度的一种方式。企业客户 可以按小时费率向核心团队请求自定义功能（通常以插件的形式）。
赞助“pr-welcome”任务
我们有一个全面的 pr-welcome 主题列表。这些是我们希望完成的任务，但目前没有精力自己处理。赞助某人处理这些任务是参与其中的好方法，并且非常感谢您对 Discourse 的任何贡献。
在 Marketplace 上提供付费工作
如果您需要对您的业务至关重要的插件，请在 Marketplace 上发布付费任务。提供尽可能多的详细信息，包括屏幕截图和预算。您还可以找到提供标准化微服务的自由职业者，例如“一次性安装”或“个性化主题”。
总体
一般注意事项
做
- 保持您的请求简洁，并专注于单个功能
- 避免对实现或技术细节做出假设
- 表现出愿意根据社区反馈妥协和调整您的想法
不做
- 每个主题包含多个功能
- 让其他人质疑您请求的范围
常见问题解答
问：如果我没有时间创建详细的功能请求怎么办？
答：如果您当时无法创建详细的请求，请仔细考虑您想说什么，然后稍后再试。这可以确保您提出最好的论点，从而增加其他人支持您的请求并最终实现它的机会。
问：我应该在哪里发布我的功能请求？
答：使用适当的类别 - 功能请求应放在 Feature 类别中。
问：如果我不确定要为我的请求使用什么标签怎么办？
答：虽然标签与插件和主题组件名称匹配以便于使用，但如果标签为空，团队成员或 Regular 会为您的主题添加适当的标签。
在您的请求中保持尊重和开放的心态。避免使用功能请求来表达沮丧。任何不当的语言或行为都可能导致您的请求被延迟或忽略。
附加资源
- Feature - Discourse Meta
- Plugin - Discourse Meta
- https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request
- How do we decide what goes into each release of Discourse?
- Discourse pricing | Discourse - Civilized Discussion
- Marketplace - Discourse Meta
- https://meta.discourse.org/c/releases
- Upcoming feature to-do list
- Topics tagged planned
- Extras - Discourse Meta
