Reporting a bug or a suggestion

Despite the care given to FreshRSS, it’s still possible that bugs occur. Development is dynamic, so issues can be corrected quickly. You might also have a feature in mind that doesn’t yet exist. Regardless whether your idea seems silly, far-fetched, useless or too specific, please don’t hesitate to propose it to us! “Ideas in the air” often find an attentive ear. It’s new external perspectives that make the project evolve the most.

If you’re convinced that you should be heard, here’s how you can go about it.

On GitHub

GitHub is the ideal platform to submit your requests. It allows us to discuss a problem or suggestion with others and it often generates new ideas. Let’s not neglect this “social” aspect!

  1. Go to the bug ticket manager
  2. Start by checking if a similar request hasn’t already been made. If so, please feel free to add your voice to the request.
  3. If your request is new, open a new bug ticket
  4. Finally, write your request. If you’re fluent in English, it’s the preferred language because it allows for discussion with the largest number of people.
  5. Please follow the tips below to make it easier to let your ticket be heard.

Informal

Not everyone likes or uses GitHub for a variety of legitimate reasons. That is why you can also contact us in a more informal way.

Tips

Here are some tips to help you present your bug report or suggestion:

In addition, when facing a bug, you’re encouraged to follow this message format (from the Sam & Max website:

What’s my goal?

Give the general context of what you were trying to do.

What have I been trying to do?

Explain step by step what you have done so that we can reproduce the bug.

What results have I achieved?

The bug: what you see that shouldn’t have happened. Here you can provide the logs.

What was the expected result?

So that we understand what you consider to be the problem.

What are my circumstances?

Remember to give the following information if you know it:

  1. Which browser? Which version?
  2. Which server: Apache, Nginx? Which version?
  3. Which version of PHP?
  4. Which database: SQLite, MySQL, MariaDB, PostgreSQL? Which version?
  5. Which distribution runs on the server? And… which version?

How to provide feed data

If you need us to investigate a feed problem, it will be easier if you provide a snapshot of the feed data. To do that, you can launch the following command:

wget <feed url> -O output.rss.txt

Then you can drag-and-drop the generated file into the issue.