PCGen Jira Guide

Introduction

Welcome to the Wiki section for the PCGen Jira Guide! This guide will walk you through on how to enter Bugs and Feature Requests into our new JIRA issue tracking system.

Creating a new account

• Go to [1] and fill out the details

Logging In

• Go to [2] and enter you username and password

Dashboard

Initially you will be shown a Dashboard with:

• 5 projects down the LHS (Code, Data, Documentation, Output Sheets and New Tag)
• Your filters and any items assigned to you on the RHS

Entering a New Issue

• You can select the CREATE NEW ISSUE in the top menu or go directly to [3]

1. Select the project that this issue is appropriate for.
2. Select the issue type
3. Click on the Next button

Try to pick these carefully, but don't worry too much if you get it wrong, the [Tracker] team will correct the details for you later if need be.

In the next section you'll want to edit as many of the fields as possible, but on the ones marked with an asterisk are mandatory.

Mandatory Fields

• Summary - A brief description of the problem/feature you're reporting, e.g. "Chainmail AC bonus doesn't stack with Shield"
• Priority - You can click on the (?) button to get an explanation of the priorities, or go directly to [4]
• Reporter - This should be your username

Optional Fields

These fields are very useful to the PCGen team, so please do take time to fill them out as much as possible!

• Component/s - What part(s) of PCGen does this issue affect? NOTE If there is a Component option you'd like to see in the list, please drop a note to the PCGen Webteam mailing list.
• Affects Version/s - Which version of PCGen are you using?
• Fix Version/s - If you are a team member and have a fair understanding on our roadmap, you can select which version of PCGen this will be fixed in. Otherwise, just leave this blank, the [Tracker] team will allocate a Fix Version later.
• Assignee - If you are a team member or a team member has specifically asked you to assign it to them then you can select that person here.
• Environment - Here we'd like you to put in your Operating System, the version of Java that you're using and how much memeory you are running PCGen with
• Description - Enter the full description of the issue here, the more detail the better!
• Original Estimate - If you are a team member and already have a fair idea of how long it will take to fix this issue, then you can enter that here.
• Attachment - You can attach, screenshots, PCG files, Data files etc here.