The following is a set of guidelines about making contributions to NG-ZORRO. Please spend several minutes in reading these guidelines before submitting an issue or pull request.
Code of Conduct#
We have adopted a Code of Conduct that we expect every contributor to adhere to. Please look through each section carefully so that you can understand what actions will and will not be allowed.
All work on NG-ZORRO happens directly on GitHub. Both core team members and external contributors go through the same reviewing process in order to submit a pull request.
Before reporting a new bug, please make sure you have filtered existing issues, and read our FAQ.
Propose a Change#
If you intend to change a public API or introduce a new feature, we also recommend you to use our issue helper to submit a feature request issue.
Your First Pull Request#
Please use the following resources for your first pull request:
To help you get your feet wet and get familiar with our contribution process, we have a list of Good First Issue that contain either bugs that are relatively easy to be fixed or small features. These issues are considered as great starting points.
If you decide to handle an issue, please be sure to check the comment thread in case someone else has already been working on it. If nobody is working on it at the moment, please leave a comment stating that you intend to work on it, preventing others from doing duplicate work.
If somebody claimed an issue without any follow up for more than two weeks, it should be fine to take over it. Nevertheless, be sure to leave a comment under such issues.
The core team is monitoring all pull requests. Your pull request will be either successfully merged, requested for a change, or closed with a reasonable explanation.
Before submitting a pull request, please make sure to follow the steps below:
npm installin the repository root.
- If you have fixed a bug or added a feature that should be tested, please add test cases!
- Make sure the test suite passes (
npm run test).
- Make sure your code lints (
npm run lint).
- Make sure rebase your code to keep the history clean.
- Make sure your commit message meet the requirements of guidelines
How to Submit a Pull Request#
- Fork the repository of
ng-zorro-antd. The later steps must be done on the forked repository
git remote add upstream https://github.com/NG-ZORRO/ng-zorro-antd.git
git pull upstream master
git push origin master
- Checkout to the feature branch (for example, if the branch is called
git checkout docs-fix
docs-fixrebase on master:
git rebase origin/master
docs-fixresolve codes and commit:
git commit -a, you need to follow the commit message guidelines
- Then, push up:
git push(might need
-f, just be sure you understand force pushing before you do it)
- Submit a Pull Request on the Github
ng-zorro-antd and running
npm install to install its dependencies, you can also run the following commands:
npm startruns NG-ZORRO website locally.
npm run lintchecks the code style.
npm testruns the complete test suite.
npm run test:watch [name]run some test files and monitor changes.
npm run build:libcreates a build of
If you encounter problems while developing
ng-zorro-antd, please refer to our development guide on the GitHub.