# Reporting Issues

XStream tracks and manages its issues in JIRA of Atlassian, that is supported by the Codehaus infrastructure and is free for open source development.

## JIRA Account

Before you can report, comment or vote for an issue you need an account in JIRA. You will find in the upper right corner of the JIRA mask a Login link. Follow it and either login if you already have an account otherwise simply sign up. This is necessary to reduce spam in the system and as benefit you can be notified if work is done on your reported issues.

## Policy

Please, before opening a new issue look through the open or resolved ones, you may already find your problem. Also do not use the system to ask questions, for that purpose we have a user list. We read the list continuously. If you are unsure whether the problem is caused by a bug or your usage of XStream, use the user's list first. If we can confirm a bug, you may still open an issue. Also do not report on the list that you have created a new issue, we are already notified by the system.

If you like to contribute code, we prefer a patch/diff in contrast to the complete modified file - unless the file itself is new. Please provide also unit tests, XStream has a high test coverage and we like to keep this. Additionally, if you provide new files, please also add a header with the copyright. It must be a BSD license, simply take the header of any other file in the distribution as template. Otherwise we might not be able to add any code of you.

Browse XStream in JIRA now.

# Software

- About XStream
- News
- Change History
- About Versioning

# Evaluating XStream

- Two Minute Tutorial
- Object references
- Tweaking the Output
- License
- Download
- References
- Statistics

# Using XStream

- Architecture Overview
- Converters
- Frequently Asked Questions
- Users' Mailing List
- JavaDoc Core
- JavaDoc Benchmark
- Reporting Issues

# Tutorials

- Two Minute Tutorial
- Alias Tutorial
- Annotations Tutorial
- Converter Tutorial
- Object Streams Tutorial
- Persistence API Tutorial
- JSON Tutorial

# Developing XStream

- How to Contribute
- Developers' Mailing List
- Development Team
- Source Repository
- Continuous Integration