Skip to content

Commit

Permalink
docs(faq): add rule for issue (#1861)
Browse files Browse the repository at this point in the history
  • Loading branch information
atian25 authored Dec 21, 2017
1 parent 3bcf933 commit 4c1617a
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 1 deletion.
14 changes: 13 additions & 1 deletion docs/source/en/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,19 @@ title: FAQ

If you have questions that is not contained below, please check [Egg issues](https://github.com/eggjs/egg/issues).

## Why my config don't work ?
## How to feedback efficiently?

Thank you for reporting an issue.

1. It's RECOMMENDED to submit PR for typo or tiny bug fix.
2. If this's a FEATURE request, please provide: details, pseudo codes if necessary.
3. If this's a BUG, please provide: course repetition, error log and configuration. Fill in as much of the template below as you're able.
4. **It will be nice to use `egg-init --type=simple bug` to provide a mini GitHub repository which can reproduce the issue.**

Most importantly, please understand one thing: the relationship between the `user` and `the maintainer of open source project` is not `Buyer` and `Seller`, the issue is not a customer order either.
When you're opening an issue, please hold a mentality of "working together to solve this problem." Do not expect us to serve you unilaterally.

## Why my config don't work?

Framework [Config](./basics/config.md) settings is powerfull, support different environments and different places(framework, plugins, app).

Expand Down
12 changes: 12 additions & 0 deletions docs/source/zh-cn/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,18 @@ title: 常见问题

如果下面的内容无法解决你的问题,请查看 [Egg issues](https://github.com/eggjs/egg/issues)

## 如何高效的反馈问题?

感谢您向我们反馈问题。

1. 我们推荐如果是小问题(错别字修改,小的 bug fix)直接提交 PR。
2. 如果是一个新需求,请提供:详细需求描述,最好是有伪代码示意。
3. 如果是一个 BUG,请提供:复现步骤,错误日志以及相关配置,并尽量填写下面的模板中的条目。
4. **如果可以,尽可能使用 `egg-init --type=simple bug` 提供一个最小可复现的代码仓库,方便我们排查问题。**
5. 不要挤牙膏似的交流,扩展阅读:[如何向开源项目提交无法解答的问题](https://zhuanlan.zhihu.com/p/25795393)

最重要的是,请明白一件事:开源项目的用户和维护者之间并不是甲方和乙方的关系,issue 也不是客服工单。在开 issue 的时候,请抱着一种『一起合作来解决这个问题』的心态,不要期待我们单方面地为你服务。

## 为什么我的配置不生效?

框架的配置功能比较强大,有不同环境变量,又有框架、插件、应用等很多地方配置。
Expand Down

0 comments on commit 4c1617a

Please sign in to comment.