Differences between revisions 7 and 8
Revision 7 as of 2014-02-01 16:01:29
Size: 3259
Editor: BasBosman
Comment: Removed some unwanted autolinking
Revision 8 as of 2015-04-07 18:32:31
Size: 1385
Editor: AndrewGrieve
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
Cordova has as a goal to be relevant on mobile platforms, and thus we prioritize bugs that are reproducible on real devices over emulators. If you are filing an issue that is device-specific, please provide as much information about the hardware as possible! Anyone can create an account and file an issue. Please try and look for existing issues first though.
Line 7: Line 7:
When you go to Create an Issue, you will be presented with a dialog with a bunch of forms. The important ones to fill out are: When you go to Create an Issue, the only fields to care about are:
Line 10: Line 10:
 * Priority: generally keep it to the default of "Major", unless it's a crash, freeze, or something of the like. If you deem the issue as "minor", might be a good idea to change the priority to "minor" as well :)
 * Due Date: this field is never used nor paid attention to, so don't even!
Line 13: Line 11:
 * Affects Versions: add any versions of Cordova that you experience the problem with.
 * Fix Versions: this will be set by contributors and committers once the issue is resolved. This field tells you in what version of Cordova the issue was fixed.
 * Assignee: please leave this at automatic.
 * Environment: if you have any additional details about your machine's environment (OS, version, etc.), please provide it here.
Line 19: Line 13:
= Filing an API Addition or New Feature =

The spirit of the Cordova project is platform-agnostic. As such, when introducing new features, it is important to consider all platforms that are part of the Cordova family. Understandably, not all contributors have the time, resources or equipment to effectively test and implement new features across the several+ platforms Cordova supports. The middle ground, then, is to keep track of which features have landed in which platforms. The Cordova project does so via the issue tracker. JIRA allows for filing issues with sub-issues. Thus, to track a complex feature such as this, file a top-level issue and create sub-tasks for:

 * Documentation
 * Test(s) (mobile-spec)
 * cordova-cli integration, if applicable
 * All platforms related to the issue (try to include as many as possible), with the core ones being:
  * Android
  * !BlackBerry (10)
  * iOS
  * FirefoxOS
  * Windows Phone 7
  * Windows Phone 8
  * Windows 8
  * Optionally, "less" mainstream platforms such as Bada, Tizen, QT, and webOS.
For feature requests, please discuss them by joining and mailing our [[http://cordova.apache.org/#mailing-list|Mailing List]]

Filing an issue on JIRA

We use JIRA to track bugs, and thus you will need an account with JIRA!

Anyone can create an account and file an issue. Please try and look for existing issues first though.

When you go to Create an Issue, the only fields to care about are:

  • Summary: provide a decent title for your issue!
  • Components: this field is important. Tag any (possibly more than one) component that is directly tied into your issue. If you had an issue with the Android implementation, add Android as a component. If it's purely a JavaScript problem (and not platform specific), tag it as CordovaJS. CLI: CLI. Documentation: Docs.

  • Description: be as in-depth as you need to be. If you are unsure if you should provide code, you probably should provide code. Remember, any committer or contributor tackling your issue needs to a) reproduce the problem, b) write a test for it, c) write a patch, and d) check that the test passes. The more information you can provide, the better. If you want to take it to a next level, provide a test, screenshots, or any other additional information that can make going through a), b), c) and d) easier.

For feature requests, please discuss them by joining and mailing our Mailing List

ReportingBugs (last edited 2015-04-07 18:32:31 by AndrewGrieve)