# 撰写高效功能请求：分步指南

**URL:** <https://meta.discourse.org/t/writing-an-effective-feature-request-a-step-by-step-guide/327385>\
**Category:** Users\
**Created:** [2024年九月20日 08:52 UTC](https://meta.discourse.org/t/writing-an-effective-feature-request-a-step-by-step-guide/327385 "2024-09-20T08:52:16Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![ondrej](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ondrej/32/198804_2.png) [@ondrej](https://meta.discourse.org/u/ondrej)\
**Post date:** [2024年九月20日 08:52 UTC](https://meta.discourse.org/t/writing-an-effective-feature-request-a-step-by-step-guide/327385/1 "2024-09-20T08:52:16Z")

</div>

## 摘要

本文档主题涵盖如何在 Discourse 中撰写功能请求：分步指南。

## 第 1 步：开始之前

所以，你有一个绝佳的 Discourse 功能创意？太棒了！以下是如何有效地与团队和社区分享它的方法。在提交功能请求之前，请花一点时间搜索现有讨论，看看你的想法是否已被提出或实现。你可以通过以下几种方式完成：

- 查看 #Contribute > Feature 分类
- 点击页面右上角的 🔍 图标以打开 [搜索](https://meta.discourse.org/search?q=%23feature) 功能。你可以使用高级过滤器按分类和标签进行筛选。
- 浏览带有 #pr-welcome 标签的主题 — _PR 指的是 GitHub 上的拉取请求，是开发者向项目引入新代码的一种方式。_
- 浏览带有 #completed 标签的主题
- 查看 #Customization > Plugin 和 #Customization > Theme component 分类

如果你的功能建议已被列出，你可以通过投票使其请求更显眼、点赞，并回复补充想法或使用案例，进一步说明该功能为何应被添加，从而支持它。

找不到任何关于你想法的提及？你可以创建一个功能请求。

* * *

## 第 2 步：基础知识

**标题**  
主题标题需要具有信息量，但同时不能过长。请求的范围应一目了然。

**分类**  
创建新主题时，请选择 #Contribute > Feature 分类。

**标签**  
标签用于分组和分类功能，因此，为了保持请求的有序性，为你的主题添加适当的标签对跟踪工作非常有帮助。例如，所有与 #chat 插件相关的内容都统一在一个标签下。

 ![标签的使用](https://global.discourse-cdn.com/meta/original/4X/8/9/8/898f1e84b2954e2445a84e543c97c9737351ac2e.png)

* * *

## 第 3 步：撰写你的请求

撰写一个良好的功能请求非常重要，它有助于 Discourse 团队快速识别需要改进的领域。

请记住，在创建功能请求时，你是在推销你的想法，并说服他人你的功能创意是有充分依据的。解释为什么你希望将_你的_功能添加到：社区、你自己以及团队中。

在主题正文中，简明扼要地说明你请求的功能。要具体且具有描述性，避免模糊或开放式表述。

### 提供背景和解释

为你的功能请求提供背景和解释。

- 对你所请求功能的清晰描述
- 包括你当前遇到的问题或使用案例，以及你的功能将如何解决这些问题
- 任何相关的背景信息或你已完成的调研

### 提供示例和截图（可选）

如果适用，请提供示例、线框图或截图，以帮助说明你的功能请求，使他人能够轻松想象你的想法。

### 与社区互动

创建功能请求后，通过回复问题和反馈与成员互动。这将提高你的请求被考虑的可能性。

**接下来会发生什么**

提交功能请求后，它将由社区和 Discourse 团队进行审查。你可以期待：

- 来自社区的反馈和讨论
- Discourse 工作人员的回复，说明你的请求是否可行并正在考虑中
- 你的功能请求可能在未来的更新中得到实现

* * *

## 想确保你的功能被实现吗？

在某些情况下，功能请求可能不适合核心开发。你可以 [阅读功能决策是如何制定的](https://meta.discourse.org/t/how-do-we-decide-what-goes-into-each-release-of-discourse/20870)。如果你无法自行开发该功能，仍有一些方法可以增加其被实现的机会。

### 成为 [discourse.org](http://discourse.org/) 客户

如果你希望通过在我们这里托管网站来资助开发 — 我们总是优先处理客户请求的开发时间表 — 这是一种更快的实现方式。[企业客户](https://discourse.org/enterprise) 可以按小时费率向核心团队请求定制功能（通常以插件形式）。

### 赞助一个“pr-welcome”任务

我们有一份全面的 [pr-welcome](https://meta.discourse.org/tag/pr-welcome) 主题列表。这些是我们非常希望完成但目前没有足够带宽自行处理的任务。赞助他人完成这些任务是参与其中的绝佳方式，任何 [对 Discourse 的贡献](https://meta.discourse.org/t/contributing-to-discourse/53797) 都备受感激。

### 在市场提供付费工作

如果你需要一个对你的业务至关重要的插件，可以在 #Marketplace 上发布付费任务广告。尽可能提供详细信息，包括截图和预算。你也可以找到提供标准化微服务的自由职业者，例如“一次性安装”或“个性化主题”。

* * *

## 总体建议

**一般注意事项**

建议

- 保持你的请求简洁，专注于单一功能
- 避免对实现或技术细节做出假设
- 展示愿意根据社区反馈妥协和调整你的想法

不建议

- 在一个主题中包含多个功能
- 让他人对你的请求范围产生疑问

## 常见问题解答

**问：如果我没有时间创建详细的功能请求怎么办？**  
答：如果当下无法创建详细请求，请仔细思考你想表达的内容，稍后再试。这能确保你提出最有力的案例，从而提高他人支持你的请求并使其被添加的机会。

**问：我应该在哪里发布我的功能请求？**  
答：使用适当的分类 — 功能请求应放在 #feature::category 分类中。

**问：如果我不确定该使用什么标签怎么办？**  
答：虽然标签通常与插件和主题组件名称匹配以方便使用，但如果标签留空，团队成员或常客会为你的主题添加合适的标签。

> 请在你的请求中保持尊重和开放的心态。避免利用功能请求表达挫败感。任何不当的语言或行为都可能导致你的请求被延迟或忽略。

## 附加资源

- 分类：#Contribute > Feature, #Marketplace, #Customization > Plugin, #Customization > Extras, #Customization > Theme, #Customization > Theme component
- 标签：#current-projects, #release-notes, #pr-welcome, #planned
- [https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request](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?](https://meta.discourse.org/t/how-do-we-decide-what-goes-into-each-release-of-discourse/20870)
- [Discourse pricing | Discourse - Civilized Discussion](https://discourse.org/pricing)

---

_[View the full topic](https://meta.discourse.org/t/writing-an-effective-feature-request-a-step-by-step-guide/327385)._