mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-21 13:18:04 +08:00
59 lines
3.5 KiB
Markdown
59 lines
3.5 KiB
Markdown
# Contributing to Ant Design
|
|
|
|
The following is a set of guidelines for contributing to Ant Design. Please spend several minutes in reading these guidelines before you create an issue or pull request.
|
|
|
|
Anyway, these are just guidelines, not rules, use your best judgment and feel free to propose changes to this document in a pull request.
|
|
|
|
|
|
## Do your homework before asking a question
|
|
|
|
It's a great idea to read Eric Steven Raymond's [How To Ask Questions The Smart Way](http://www.catb.org/esr/faqs/smart-questions.html) twice before asking a question. But if you are busy now, I recommend to read [Don't post homework questions](http://www.catb.org/esr/faqs/smart-questions.html#homework) first.
|
|
|
|
The following guidelines are about *How to avoid Homework Questions*.
|
|
|
|
### 1. Read the documentation.
|
|
|
|
It sad but true that someone just glance(not read) [Ant Design's documentation](http://ant.design/). Please read the documentation closely. What's more, you can modify and run our demo with [CodePen](http://codepen.io/benjycui/pen/KgPZrE?editors=001). It's helpful to understand our documentation.
|
|
|
|
Tips: choose the corresponding documentation with versions selector which in the bottom-right corner.
|
|
|
|
### 2. Make sure that your question is about Ant Design, not React
|
|
|
|
Someone may think all of the questions that he/she meets in developing are about Ant Design, but it's not true. So, please read [React's documentation](http://facebook.github.io/react/docs/getting-started.html) or just Google (not Baidu, seriously) your questions with keyword *React* first. If you are sure that your question is about Ant Design, go ahead.
|
|
|
|
### 3. Read the FAQ and search the issues list of Ant Design
|
|
|
|
Your questions may be asked and solved by others. So please spend several minutes on searching. Remember [DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself), both code and questions.
|
|
|
|
P.S.
|
|
|
|
1. [FAQ](https://github.com/ant-design/ant-design/wiki/FAQ)
|
|
1. [Issues list](https://github.com/ant-design/ant-design/issues)
|
|
|
|
## Close your issue if it's solved
|
|
|
|
It is a good habit which will save maintainers' time. Thank you!
|
|
|
|
## Providing a demo while reporting a bug
|
|
|
|
It would be helpful to provide a demo which can re-produce the bug 100%. Please fork this [CodePen](http://codepen.io/benjycui/pen/KgPZrE?editors=001) and re-produce the bug you met. Then, create an issue. The most important thing is: double check before claiming that you have found a bug.
|
|
|
|
|
|
## Tips about Feature Request
|
|
|
|
If you believe that Ant Design should provide some features, but it does not. You could create an issue to discuss. However, Ant Design is not Swiss Army Knife, there are some features which Ant Design will not support:
|
|
|
|
1. Request or operate data
|
|
|
|
|
|
## Tips about Pull Request
|
|
|
|
**Working on your first Pull Request?** You can learn how from this *free* series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)
|
|
|
|
It's welcomed to pull request. And there are some tips about that:
|
|
|
|
1. It is a good habit to create a feature request issue to discuss whether the feature is necessary before you implement it. However, it's unnecessary to create an issue to claim that you found a typo or improved the readability of documentation, just create a pull request.
|
|
1. Run `npm run lint` and fix those errors before committing in order to keep consistent code style.
|
|
1. Rebase before creating a PR to keep commit history clear.
|
|
1. Add some descriptions and refer relative issues for you PR.
|