View Source

{section}
{column}

h1. Petals Link's JIRA

Bugs and features requests concerning Petals Studio must be reported on [our JIRA|http://jira.petalslink.com].
To post a ticket, you must be logged in. For those who are not yet registered, it is possible to create a JIRA account.
Once you are logged in, go into *Projects* and select *Petals-Studio* in the list of projects.
{column}
{column:width=350px}
{panel:title=Table of contents}{toc}{panel}
{column}
{section}

h1. Bug // Improvement // New Feature // Task

Once in the studio's category, you have the choice between creating a bug report, an improvement report, a feature request or a task.
Pay attention to the kind of entry to create.

!PetalsStudio_ReportingJira_2.jpg!

h2. Bugs

A bug is defined as « *a problem which impairs or prevents the functions of the product* ».
Generally, the definition of a bug is well-understood.

h2. Improvements

An improvement is defined as « *an improvement or enhancement to an existing feature or task* ».
One example of a new feature would be an extension of the validation made on jbi.xml files (the validation mechanism already exists).

h2. New Features

A new feature is defined as « *a new feature of the product, which has yet to be developed* ».
One example of a new feature would be the addition of a new editor in the studio (e.g. for XSLT).

h2. Tasks

A task defines « *a change that does not impact directly the user* ».
One example of a task would be upgrading the version of a parsing library.

h1. Tooling categories

Petals Studio has (for the moment) 4 sub-categories in which you can post tickets.
* *Petals Tools* includes all the Petals plug-ins, except those for BPEL and SCA.
* *BPEL Tools* includes all the plug-ins related to BPEL (creation wizard, sketch export, BPEL Designer, validation...).
* *SCA Tools* includes all the plug-ins related to SCA (creation wizards, editors, validation...).
* *Eclipse Tools* includes all the Eclipse plug-ins shipped with the studio but which are not directly related to Petals (Java Tooling...).
* *Studio Product* includes all the plug-ins related to the studio itself (e.g. welcome page, executable), plus the build mechanism.

When you create a JIRA ticket, pay attention to the category for which this ticket fits.

!PetalsStudio_ReportingJira_1.jpg!


h1. Reporting bugs efficiently

When you report a bug about the Petals Studio, please, be precise.
* Mention the *version* of the studio, and if you can, mention the *build ID* too.
This information can be found in the About dialog (*Help > About Petals Studio*).

!PetalsStudio_ReportingJira_3.jpg!

\\
* Report the log messages if any.
If a problem occurs, look at the *Error Log* (*Window > Show view > Other...* and then *General > Error Log*).
Post the log details in any bug entry you create on JIRA.