How to Contribute
We would love for you to contribute to AngularJS/Angular upgrade project and help make it even better than it is today! As a contributor, here are the guidelines we would like you to follow:
As contributors and maintainers of the upgrade project from AngularJS to Angular, we pledge to respect everyone who contributes by posting issues, updating documentation, submitting pull requests, providing feedback in comments, and any other activities.
Communication through any of upgrade channels (GitHub, mailing lists, Google+, Twitter, etc.) must be constructive and never resort to personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
We promise to extend courtesy and respect to everyone involved in this project regardless of gender, gender identity, sexual orientation, disability, age, race, ethnicity, religion, or level of experience. We expect anyone contributing to the Angular project to do the same.
If any member of the community violates this code of conduct, the maintainers of the Angular project may take action, removing issues, comments, and PRs or blocking accounts as deemed appropriate.
If you are subject to or witness unacceptable behavior, or have any other concerns, please email us at [email protected].
Here is where you can finally ask all those nitty gritty or general upgrade questions and have experts respond. The issues tab will be our questions and answers section. Any closed issue means we have concluded a good answer and any open means they still need an answer.
Before you submit an issue, please search the issue tracker, an issue for your problem could already exist.
We want to understand all the issues and often need code to understand your problem. In order to demonstrate your problem, we will systematically ask you to provide a minimal reproduction scenario using http://plnkr.co. Having a live, reproducible scenario gives us a wealth of important information without going back & forth to you with additional questions like:
- version of AngularJS used
- 3rd-party libraries and their versions
- and most importantly - a use-case that fails
A minimal reproduce scenario using http://plnkr.co/ allows us to quickly confirm a bug (or point out coding problem) as well as confirm that we are fixing the right problem. If plunker is not a suitable way to demonstrate the problem, please create a standalone git repository demonstrating the problem.
We will be insisting on a minimal reproduce scenario in order to save maintainers time and ultimately be able to fix more bugs. Interestingly, from our experience users often find coding problems themselves while preparing a minimal plunk. We understand that sometimes it might be hard to extract essentials bits of code from a larger code-base but we really need to isolate the problem before we can fix it.
You can file new issues by filling out our new issue form.
This Wiki tab is where all documentation on upgrading, migration paths, available tools, and examples will live. Please follow the documentation guidelines below.
Since this is an opensource forum, it is up to you to add new features, tools, or documentation. We request that you follow our guidelines when adding new features and removing existing features. Please refer to the terminology and reasons for removing pages when adding or removing documents.
Please do not vere from the standard terminologies used in this document. To provide a clear standard for how to refer to certain terms, please refer to the terminology page. Most common terms used are:
Angular is the name for the Angular of today and tomorrow.
AngularJS is the name for all 1.x versions of Angular.
