h4. *JIRA* is a issue tracking and project management system that you access from your web browser.
The complete JIRA documentation from Atlassian is available [here|http://confluence.atlassian.com/display/JIRA/JIRA+User%27s+Guide].
To obtain a JIRA account, add a new project, and/or adjust permissions, please contact [Holly Mistlebauer|mailto:hlm7@cornell.edu].
{lozenge:title=Login to JIRA|icon=JIRA|link=http://issues.library.cornell.edu/|color=red}
{lozenge}
h6. JIRA consists of *Projects* that contain *Issues*
[What is an Issue?|http://confluence.atlassian.com/display/JIRA/What+is+an+Issue]
[What is a Project?|http://confluence.atlassian.com/pages/viewpage.action?pageId=185729449]
h6. [Customizing the Dashboard|http://confluence.atlassian.com/display/JIRA/Customising+the+Dashboard]
Have issues that are assigned to you show up on your JIRA Dashboard (aka home page).
Have easy access to your project(s), favorite filters, etc. as well.
h6. [Managing your User Profile|http://confluence.atlassian.com/display/JIRA/Managing+your+User+Profile]
Change your Password, Profile, and Preferences.
h6. [Creating and working with Issues|https://confluence.atlassian.com/display/JIRA/Working+with+an+Issue]
[Creating an Issue|http://confluence.atlassian.com/display/JIRA/Creating+an+Issue]
Create several issues within the "Move to New Library" JIRA project.
Assign one to yourself and one to someone else in the group.
Check your email to see the notification.
[Editing an Issue|https://confluence.atlassian.com/display/JIRA051/Editing+an+Issue]
Edit one or more issues that you created.
Reassign one of your issues to a classmate.
Resolve or Close one of your issues.
[Commenting on an Issue|http://confluence.atlassian.com/display/JIRA/Commenting+on+an+Issue]
Add comments to the issues you created above.
[Emailing an Issue|https://confluence.atlassian.com/display/JIRA051/Emailing+an+Issue]
Email one of your issues to a classmate who the issue is not assigned to.
[Attaching a File|https://confluence.atlassian.com/display/JIRA/Attaching+a+File]
Attach a file to one of the issues you created above.
[Linking Issues|http://confluence.atlassian.com/display/JIRA/Linking+Issues]
Link one or more issues together.
[Creating a Sub-Task|http://confluence.atlassian.com/display/JIRA/Creating+a+Sub-Task]
Create several sub-tasks for the tasks you created above.
See how the sub-tasks appear when viewing the task.
Although not covered in the workshop, you may also...
[Attach a screenshot to an issue|https://confluence.atlassian.com/display/JIRA051/Attaching+a+Screenshot]
[Clone an issue|https://confluence.atlassian.com/display/JIRA051/Cloning+an+Issue]
[Label an issue|https://confluence.atlassian.com/display/JIRA051/Labelling+an+Issue]
[Log work on an issue|https://confluence.atlassian.com/display/JIRA051/Logging+Work+on+an+Issue]
[Modify multiple issues at one time|https://confluence.atlassian.com/display/JIRA051/Modifying+Multiple+%28%27Bulk%27%29+Issues]
[Move an issue to another project|https://confluence.atlassian.com/display/JIRA051/Moving+an+Issue]
[Schedule an issue|https://confluence.atlassian.com/display/JIRA051/Scheduling+an+Issue]
[Set security on an issue|https://confluence.atlassian.com/display/JIRA051/Setting+Security+on+an+Issue]
[Watch issues|https://confluence.atlassian.com/display/JIRA051/Watching+and+Voting+on+an+Issue]
h6. [Searching for Issues|http://confluence.atlassian.com/display/JIRA/Searching+for+Issues]
[Using Quick Search|http://confluence.atlassian.com/display/JIRA/Using+Quick+Search]
Search for one of your issues by number (TRAIN-#).
Search for issues assigned to you (my).
[Searching for Issues|http://confluence.atlassian.com/display/JIRA/Searching+for+Issues#SearchingforIssues-Searchingforissues]
Search for the issues you created (which makes you the Reporter) using a Simple Search.
We will not cover Advanced Search in this workshop.
[Saving Searches (aka Using Filters)|http://confluence.atlassian.com/display/JIRA/Saving+Searches+(%27Issue+Filters%27)]
Save your search.
Share your search with the training-users group.
Try the shared searches created by your classmates.
[Using the Issue Navigator|http://confluence.atlassian.com/display/JIRA/Using+the+Issue+Navigator]
[Customizing your Issue Navigator|http://confluence.atlassian.com/display/JIRA/Customising+your+Issue+Navigator]
Move fields around within the Issue Navigator.
Add a new field to Issue Navigator.
Note that the results can be printed or exported to Word, Excel, PDF, XML, etc.
h6. [Browsing a Project|http://confluence.atlassian.com/display/JIRA/Browsing+a+Project]
Take a look at the Project Summary for the "Move to New Library" JIRA Project.
Use [Reports|https://confluence.atlassian.com/display/JIRA/Generating+Reports] option to create Pie Charts, Gantt Charts, you name it\!
Can also create "canned" reports via the Filters option. The results can be printed or exported to Word, Excel, PDF, XML, etc.
h6. Using Components and Versions
[What is a Component? Version?|http://confluence.atlassian.com/pages/viewpage.action?pageId=185729449]
Watch instructor add Components.
Edit your issues to add a Component.
Search for issues assigned a specific component.
h6. Customization
JIRA uses "schemes" to customize projects...
* [Permission Scheme|https://confluence.atlassian.com/display/JIRA051/Managing+Project+Permissions] is used to identify which users are allowed to do what with the project.
* [Notification Scheme|https://confluence.atlassian.com/display/JIRA051/Creating+a+Notification+Scheme] is used to determine who should receive an e-mail when a change is made to an issue within the project.
* [Issue Type Scheme|https://confluence.atlassian.com/display/JIRA051/Associating+Issue+Types+with+Projects] is used if you want your project to have different issue types than the default.
* [Field Configuration Scheme|https://confluence.atlassian.com/display/JIRA051/Configuring+Fields+and+Screens] is used if you want to have additional customized fields for entry or what to take away fields that aren't being used by your project.
* [Workflow Scheme|https://confluence.atlassian.com/display/JIRA051/Configuring+Workflow] is used if you want to have a non-standard workflow.
h6. JIRA Best Practices
* Don't send out e-mails about issues/tasks that are in JIRA. Simply keep all information in JIRA and let JIRA send e-mails when issues/tasks are added/updated.
* Attach documents to issues/tasks as appropriate, so all information is available in the future.
* Customize the issue/task entry page to meet your needs, including the addition of new custom fields.
* Customize the Notification Scheme so that folks do not receive unnecessary e-mails.
* Share reports (aka Filters) within the project.
* Make use of Versions so that all issues/tasks for a release/due date are reported together.
* Use Components to assign issues/tasks to the appropriate category. Each category can be assigned to the person in charge of that work.
* When using sub-tasks, give the parent task an estimate of 1 minute so that you able to quickly identify the parent tasks.
h6. H-E-L-P!
Email [mailto:cul-jira-l@cornell.edu}] if you need help.
| 
