-
-
Notifications
You must be signed in to change notification settings - Fork 812
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add Contributing file in beta branch
See #783
- Loading branch information
1 parent
4a9c228
commit 457fd79
Showing
1 changed file
with
57 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
# How to contribute to FreshRSS? | ||
|
||
## Join us on the mailing lists | ||
|
||
Do you want to ask us some questions? Do you want to discuss with us? Don't hesitate to subscribe to our mailing lists! | ||
|
||
- The first mailing is destined to generic information, it should be adapted to users. [Join mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing). | ||
- The second mailing is mainly for developers. [Join dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev) | ||
|
||
## Report a bug | ||
|
||
You found a bug? Don't panic, here are some steps to report it easily: | ||
|
||
1. Search for it on [the bug tracker](https://github.com/FreshRSS/FreshRSS/issues) (don't forget to use the search bar). | ||
2. If you find a similar bug, don't hesitate to post a comment to add more importance to the related ticket. | ||
3. If you didn't find it, [open a new ticket](https://github.com/FreshRSS/FreshRSS/issues/new). | ||
|
||
If you have to create a new ticket, try to apply the following advices: | ||
|
||
- Give an explicit title to the ticket so it will be easier to find it later. | ||
- Be as exhaustive as possible in the description: what did you do? What is the bug? What are the steps to reproduce the bug? | ||
- We also need some information: | ||
+ Your FreshRSS version (on about page or `constants.php` file) | ||
+ Your server configuration: type of hosting, PHP version | ||
+ Your storage system (MySQL / MariaDB or SQLite) | ||
+ If possible, the related logs (PHP logs and FreshRSS logs under `data/users/your_user/log.txt`) | ||
|
||
## Fix a bug | ||
|
||
Did you want to fix a bug? To keep a great coordination between collaborators, you will have to follow these indications: | ||
|
||
1. Be sure the bug is associated to a ticket and say you work on it. | ||
2. [Fork this project repository](https://help.github.com/articles/fork-a-repo/). | ||
3. [Create a new branch](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/). The name of the branch must be explicit and being prefixed by the related ticket id. For instance, `783-contributing-file` to fix [ticket #783](https://github.com/FreshRSS/FreshRSS/issues/783). | ||
4. Make your changes to your fork and [send a pull request](https://help.github.com/articles/using-pull-requests/) on the **dev branch**. | ||
|
||
If you have to write code, please follow [our coding style recommendations](http://doc2.freshrss.org/en/Developer_documentation/First_steps/Coding_style). | ||
|
||
**Tip:** if you are searching for bugs easy to fix, have a look at the « [New comers](https://github.com/FreshRSS/FreshRSS/labels/New%20comers) » ticket label. | ||
|
||
## Submit an idea | ||
|
||
You have great ideas, yes! Don't be shy and open [a new ticket](https://github.com/FreshRSS/FreshRSS/issues/new) on our bug tracker to ask if we can implement it. The greatest ideas often come from the shyest suggestions! | ||
|
||
If your idea is nice, we'll have a look at it. | ||
|
||
## Contribute to internationalization (i18n) | ||
|
||
If you want to improve internationalization, please open a new ticket first and follow indications from « Fix a bug » section. | ||
|
||
Translations are present in the subdirectories of `./app/i18n/`. | ||
|
||
We are working on a better way to handle internationalization but don't hesitate to suggest any idea! | ||
|
||
## Contribute to documentation | ||
|
||
The documentation needs a lot of improvements in order to be more useful to new contributors and we are working on it. If you want to give some help, meet us on [the dedicated repository](https://github.com/FreshRSS/documentation)! |