diff options
Diffstat (limited to 'site/contribute/issues.md')
| -rw-r--r-- | site/contribute/issues.md | 38 |
1 files changed, 10 insertions, 28 deletions
diff --git a/site/contribute/issues.md b/site/contribute/issues.md index 6edebaf..5bf0fe9 100644 --- a/site/contribute/issues.md +++ b/site/contribute/issues.md @@ -1,55 +1,37 @@ --- layout: contribute -title: Apache Cordova Reporting Issues +title: AGL Reporting Issues --- # Reporting Issues -Thank you for helping to improve Cordova! Issues for Apache Cordova are hosted at the Apache [JIRA](https://issues.apache.org/jira/browse/CB). A JIRA account is required before you can submit issues (you can easily [create one here](https://issues.apache.org/jira/secure/Signup!default.jspa)). Before submitting an issue, please take a moment to search JIRA to see if an issue already exists. If it does, please consider commenting or voting for the issue to help raise its visibility. +Thank you for helping to improve AGL! Issues for AGL are hosted on the [AGL JIRA]({{ site.linkto.jira_base }}). A Linux Foundation account is required before you can submit issues (you can easily [create one here]({{ site.linkto.account }})). Before submitting an issue, please take a moment to search JIRA to see if an issue already exists. If it does, please consider commenting or voting for the issue to help raise its visibility. ## Creating an issue in JIRA -Once you have created an account and logged in, click the blue "Create" button at the top of the [Cordova JIRA](https://issues.apache.org/jira/browse/CB) page to create an issue. In the dialog that appears, please fill out the following fields _to the best of your ability_. All fields besides those listed here can be left blank. +Once you have created an account and logged in, click the blue "Create" button at the top of the [AGL JIRA]({{ site.linkto.jira_project }}) page to create an issue. In the dialog that appears, please fill out the following fields _to the best of your ability_. All fields besides those listed here can be left blank. Field | Description ----------------| ----- -Project | Make sure that Apache Cordova is selected +Project | Make sure that 'AGL Development' is selected Issue Type | Whether or not this is a bug or feature request Summary | A one line description of the issue -Component | The [part of Cordova](https://issues.apache.org/jira/browse/CB/?selectedTab=com.atlassian.jira.jira-projects-plugin:components-panel) this issue pertains to. Please select only one component if possible (e.g. if you find a bug while using cordova-plugin-camera in Android, select the "Plugin Camera" component and not "Android") -Affects Version | The version of the component that this issue pertains to -Environment | Some extra context about the environment in which a bug was found (e.g. the version of Android you are running, your version of the Cordova CLI, your development platform, etc.) -Description | A thorough description of the issue. For bugs, please provide code (using github) or steps for reproduction as well as any device logs or stack traces you might have. -Labels | Please label your issue with the platforms it affects (e.g. ios, windows, android, etc.) and nothing else +Component | The [part of AGL]({{ site.linkto.jira_base }}browse/SPEC/?selectedTab=com.atlassian.jira.jira-projects-plugin:components-panel) this issue pertains to. Please select only one component if possible. +Affects Version | The version of the component that this issue pertains to (Blowfish, Chinook, Dab ...) +Environment | Some extra context about the environment in which a bug was found (e.g. your development platform, the target machine etc.) +Description | A thorough description of the issue. For bugs, please provide steps for reproduction as well as any logs or stack traces you might have. Priority | The impact of the issue (see below) ## Issue Priority We gauge issue priority on the following scale: + * **Minor/Trivial:** The feature or bug is very specific or only affects a few people * **Major:** The feature or bug is important and impacts many people -* **Critical:** Bugs (not features) that block the main function of a component and affect a large number of people (e.g. the camera plugin can't take pictures in iOS version x.x) +* **Critical:** Bugs (not features) that block the main function of a component and affect a large number of people * **Blocker:** Catastrophic bugs that prevent projects from building or cause basic projects to crash immediately. It is very unlikely that a bug is a Blocker If you aren't sure about the priority, leave the default (major) selected. Please be aware that as our contributors triage issues, they may change the priority based on our criteria. -## Finding out versions - -You can quickly find out versions of platforms/plugins you're using by running: - - cordova platform ls - -or - - cordova plugin ls - -in your project respectively. You can find out the version of the Cordova CLI you're using by running: - - cordova --version - -# Generating CLI logs - -You can use `--verbose` flag to generate detailed logs for cordova build-time bugs related with the CLI. This helps significantly in debugging. - |