[[TOC]]
= Ticket Submission guide =

== Introduction == 

Reporting a bug, requesting a feature or posting a patch is more than just submitting a ticket. Any successful ticket basically involves three steps:

 1. '''Gathering information'''

 Before you submit a ticket, you search the database to see if similar tickets have been submitted before. Also, you search all the required background information needed so that your ticket can be handled efficiently.

 2. '''Submitting the ticket'''

 Be verbose in your ticket description. It is hard to provide too much information, but very easy to leave out vital information.

 3. '''Wait for a solution and provide further feedback if needed'''

 Fixing bugs or implementing features can take a lot of time. While we, the developers, do read all tickets, we do not have the time to reply to every ticket instantly, nor can we fix problems instantly. But eventually your ticket will get handled.

 You need to be patient. Don't rush, posting ''BUMP'' and the likes will not help, it will only cause further delay.

 Often, a developer working on your ticket will require further information. Be ready to adequately answer the developer's questions and provide the requested information.

Please read on for more details on each of these steps.

== What are tickets? ==

This site is running '''Trac''', which is an '''issue tracking system''' and every '''ticket''' is an '''issue'''. Think of a ticket as a number an issue and all corresponding data gets filed under.

There are three types of tickets or issues:

 * '''Bug reports'''

 Bugs can be best described as unintended behavior. 

 * '''Feature requests'''

 If you would like to see certain functionality in FileZilla, then your ticket would be a feature request.

 * '''Patches'''

 Patches implement a new feature or fix bugs.

The distinction between a bug report and a feature request is not always clear, but you can follow this simple rule of thumb to come to a decision between the two: Assume you want FileZilla to perform a certain task, but cannot do it.

If there is no indication that this is possible with FileZilla, then it is a feature request. This still applies even if other programs can do it, but not FileZilla.

If there is an indication that the task you want to perform is possible with FileZilla, e.g. a button or menu item, but the action does not work or does something unexpected, then it is a bug.

=== Components ===

Each ticket describes an issue affecting a component. The components available here are:
 * '''FileZilla Client'''
 * '''FileZilla Server'''
 * '''Other'''

Select the correct component, otherwise your ticket will be closed as invalid.

=== Ticket status ===

Over its lifetime, a ticket's status can change. Initially your ticket will have the '''new''' status and eventually it will reach the '''closed''' status. Other states include '''assigned''', '''accepted''', '''reopened''' or '''moreinfo'''. The latter tells you that the ticket is missing more information from you, while you as user can treat the other states just like '''new'''.

== Information gathering ==

You do not want to ridicule yourself by submitting redundant, invalid or otherwise ''bad'' tickets. Doing so would not only waste your time, but also the time of the developers that have to look at your ticket.

=== Use the latest version ===

Most importantly, you need to make sure you are using the very latest version of FileZilla Client or Server respectively. Concerning tickets, there is nothing more embarrassing than to request a new feature that has been implemented already quite a while ago.

Make sure you are using the '''very latest version''' available directly from [http://filezilla-project.org], do not rely on your distribution to have recent enough packages.

=== Search for existing tickets ===

The next step is to search the existing tickets. A huge amount of people are using FileZilla. Chances are good that you are not alone with your issue and that it has been reported before. To search the existing tickets, click on the [Queries View Tickets] button in the navigation bar. You can then select a component and ticket type to browse. You can also search all tickets for some terms. Try searching for alternate terms too.

For example if you have an issue with the ''directory tree'', search for the alternate (but technically inaccurate) word ''folder'' as well.

In addition, have a look at the [http://forum.filezilla-project.org forums], sometimes the answer can be found there already.

== Submitting a ticket ==

== Summary ==

 * Requirements
  * Make sure you are running the latest version of FileZilla Client or Server
  * Read existing documentation
  * Search existing tickets and the forums
  * Rule out your system as problem source: Install all system updates, use recent drivers, disable firewalls, virus scanners, so-called ''security solutions'' and all other third-party software.

 * Submitting the ticket
  * '''Be verbose'''
  * Say which version you use
  * Say which operating system you use (name and version)
  * Include logs, dumps, and everything else that can help solve the issue

 * Waiting for a solution
  * Be patient
  * Be ready to answer questions and to provide further information

== Further reading ==

 * [http://www.catb.org/~esr/faqs/smart-questions.html How to ask questons the smart way] by Eric S. Raymond, Rick Moen
 * [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to Report Bugs Effectively] by Simon Tatham