How to report a bug or ask for a new feature

Found a bug? Need an enhancement? Tickets are for you! Tickets are one of the main tools we use to develop Gajim. Here you can learn how to create a good ticket. It makes our work easier and faster.

What is a ticket?

A ticket is a simple report. Tickets are useful for developers because it is the place they can see what users want, and what bugs they have.

Why should I create a ticket?

You can create a ticket for:

• Reporting a bug (NOTE: If you have a segfault please read this before reporting).
• Ask a new feature
• Add a task

Before creating

Before posting, you must check that such a ticket haven't already been posted.

How can I check if somebody else created such a ticket before?

Please use these links to have a look if someone else already had the same problem/idea:

• open tickets that need to be fixed
• bugs (including closed) by modules:
  • chat window, dialogs, preferences, roster (main window), xmpppy (core), ...
  • ... select the component matching your problem/idea and press update
• uncategorized tickets

You can also do a Ticket Query...

Where can I create a ticket?

Here

How should I fill in the form?

You have several information to give to create a new ticket.

Your e-mail or username

This field is used to know who reported the ticket. It is beter to speak to someone than to speak with an anonymous, isn't it?

Short summary

In a few words, explain why you created this ticket. It is used in tickets lists, rss feeds, and others.

Type

It is what is you ticket about.

• Defect: use it for Gajim bugs; if there is a problem.
• Enhancement: use it if you're asking for a new feature, an improvement of Gajim
• Task: use it if you have some work which isn't a new feature or an enhancement.

Full description

Write a description of the bug/request/task here... Be precise and complete.

Priority

Set the priority we should give to the ticket. Most of them should be set to "normal".

Component

Put the name of the module of Gajim you want to report about here. If you don't know, leave it «None».

Severity

Here you can estimate the severity of your bug/request.

Assign to

If you don't know what to put here, leave it blank.

OS

If you are reporting something which is limited to only one OS, select it in the list.

Milestone

Used to make a release shedule. Please leave it blank for new enhancement requests.

Version

This is very important for bugs: if we know which version of gajim you use, we can reproduce it easier.

Keywords

Enter some keywords for your ticket here. You are free to use any keyword you want, but if you post a patch, please add "patch" to keywords.

CC

You can put your e-mail adress here to stay informed about the evolution of your ticket.

After that

Wait and hope for some dev to comment on that ticket and/or fix your issue. If you do not understand some vocabularies read that. You can also croo your fingers ;-) If you've added your e-mail to cc, you will receive an e-mail when your ticket is updated/closed. Off course you can also write a patch yourself (please don't forget to add "patch" to keywords).

Translations

Here is a little how-to in Polish: Zgłaszanie błędów po polsku Please try to report bugs in English.