rofi/.github/CONTRIBUTING.md

When reporting bugs keep in mind that the people working on it do this unpaid, in their free time and as a hobby. So be polite and helpful. Reports that demand, contain insults to this or other projects, or have a general unfriendly tone will be closed without discussion. Everybody has it own way of working; What might be the norm for you, might not be for others. Therefore be verbose in your description.

The issue tracker is for bugs only.

This is an attempt to keep the issue tracker clean and searchable.

Questions or discussions about new features belong on FORUM, IRC, frequently asked questions will be added to the F.A.Q on the wiki.

Questions filled in on the bug tracker will be marked question, locked and closed.

It is preferred to have feature requests discussed via FORUM or IRC first.

Creating a bug report

Before creating a bug report:

• Update to the latest version. Check if problem still exists.
• Check existing bug reports, see if it is already reported.
• Read the documentation. Make sure the behaviour you are seeing is a bug.

When reporting bugs include the following information:

• Rofi version. rofi -v
• Rofi configuration. rofi -help (in a gist)
• Steps to reproduce.
• What behaviour you see.
• What behaviour you expect to see.
• A proper title for others to search for.
• Be exact.

When adding comments to an issue make sure:

• It is relevant to the issue.
• It contributes to solving the issue.
• Use 👍 👎 emojis instead of replying 'me too' or 'I also have this.'

Issue high-jacking, e.g. adding a request/issue to an existing issue, is very disruptive. Please create a new issue, if it is similar it will be marked duplicate.

Creating a feature request

Before creating a feature request:

• First check the next branch, to see if the feature has already been implemented.
• Check existing reports, see if it is already requested.

When reporting a feature request include the following information:

• Rofi version. (rofi -v)
• A clear description of the feature you want added.
• A use-case for the feature.

If possible try to explain how you would expect to use feature. For example, should it be a configuration option or a hot-key.

Requesting a feature is no guarantee it will be added.

Please do not submit reports related to wayland, see here for more information.