# Reporting New Issues
- Please specify what kind of issue it is.
- Before you report an issue, please search for related issues. Make sure you are not going to open a duplicate issue.
- Explain your purpose clearly in tags(see Useful Tags), title, or content.
Egg group members will confirm the purpose of the issue, replace more accurate tags for it, identify related milestone, and assign developers working on it.
Tags can be divided into two groups,
- type: What kind of issue, e.g.
- scope: What did you modified. Which files are modified, e.g.
# Useful Tags
support: the issue asks helps from developers of our group. If you need helps to locate and handle problems or have any idea to improve Egg, mark it as
bug: if you find a problem which possiblly could be a bug, please tag it as
bug. Then our group members will review that issue. If it is confirmed as a bug by our group member, this issue will be tagged as
- A confirmed bug will be resolved prior.
- If the bug has negative impact on running online application, it will be tagged as
critical, which refers to top priority, and will be fixed ASAP!
- A bug will be fixed from lowest necessary version, e.g. A bug needs to be fixed from 0.9.x, then this issue will be tagged as
1.1, referring that the bug is required to be fixed in those versions.
core: xx: the issue is related to core, e.g.
core: loaderrefers that the issue is related with
plugin: xx: the issue is related to plugins. e.g.
plugin: sessionrefers that the issue is related to
deps: xx: the issue is related to
deps:egg-corsrefers that the issue is related to
chore: documentation: the issue is about documentation. Need to modify documentation.
All features must be submitted along with documentations. The documentations should satify several requirements.
- Documentations must clarify one or more aspects of the feature, depending on the nature of feature: what it is, why it happens and how it works.
- It's better to include a series of procedues to explain how to fix the problem. You are also encourgaed to provide simple, but self-explanatory demo. All demos should be compiled at eggjs/examples repository.
- Please provide essential urls, such as application process, terminology explainations and references.
# Submitting Code
# Pull Request Guide
If you are developer of egg repo and you are willing to contribute, feel free to create a new branch, finish your modification and submit a PR. Egg group will review your work and merge it to master branch.
# Create a new branch for development. The name of branch should be semantic, avoiding words like 'update' or 'tmp'. We suggest to use feature/xxx, if the modification is about to implement a new feature.
Then you can create a Pull Request at egg
No one can garantee how much will be remembered about certain PR after some time. To make sure we can easily recap what happened previously, please provide the following information in your PR.
- Need: What function you want to achieve (Generally, please point out which issue is related).
- Updating Reason: Different with issue. Briefly describe your reason and logic about why you need to make such modification.
- Related Testing: Briefly descirbe what part of testing is relevant to your modification.
- User Tips: Notice for Egg users. You can skip this part, if the PR is not about update in API or potential compatibility problem.
# Style Guide
Eslint can help to identify styling issues that may exist in your code. Your code is required to pass the test from eslint. Run the test locally by
$ npm run lint.
# Commit Message Format
You are encouraged to use angular commit-message-format to write commit message. In this way, we could have a more trackable history and an automatically generated changelog.
Must be one of the following:
- feat: A new feature
- fix: A bug fix
- docs: Documentation-only changes
- style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
- refactor: A code change that neither fixes a bug nor adds a feature
- perf: A code change that improves performance
- test: Adding missing tests
- chore: Changes to the build process or auxiliary tools and libraries such as documentation generation
- deps: Updates about dependencies
The scope could be anything specifying place of the commit change. For example $location, $browser, $compile, $rootScope, ngHref, ngClick, ngView, etc...
Use succinct words to describe what did you do in the commit change.
Feel free to add more content in the body, if you think subject is not self-explanatory enough, such as what it is the purpose or reasone of you commit.
- If the commit is a Breaking Change, please note it clearly in this part.
- related issues, like
Closes #1, Closes #2, #3
- If there is a change about an old feaure or a new feature, please associate
fix($compile): [BREAKING_CHANGE] couple of unit tests for IE9
Look at these files for more detials.
egg uses semantic versioning in release process based on semver.
# Branch Strategy
master branch is the latest stable version.
next branch is the next stable version working in progress.
- All new features will be added into
nextbranch as well as all bug-fix except security issues. In such way, we can motivate developers to update to the latest stable version.
- If any API is discarded, it should be noted with
deprecatein current stable version. The old version of API should be compatiable until the release of next stable version.
masterbranch doesn't have publish tag. High-level framework can work with stable versions defined by semantic versioning.
nextbranch is labelled with
nexttag, high-level framework can use
egg@nextto test the in-progress version.
- The LTS versions of Egg determined by Milestone. If a version is listed in Milestone, then it is a LTS version. We will patch it if there is any problem with it.
# Release Strategy
In the release of every stable version, there will be a PM who has the following responsibilities in different stages of the release.
- Set up milestone. Confirm that request is related to milestone. Assign and update issues, like 1.x milestone.
- Create a
masterbranch and tag it as
# Before Release
Confirm that performance test is passed and all issues in current Milestone are either closed or can be delayed to later versions.
Open a new Release Proposal MR, and write
Historyas node CHANGELOG. Don't forget to correct content in documentation which is related to the releasing version. Commits can be generated automatically.
$ npm run commits
Nominate PM for next stable version.
# During Release
All tags mentioned above refere to adding tags from npm in