CONTRIBUTING.md 2.56 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
# Foreword

## Contributing is not only about throwing code

Any project needs several different profiles. Contributing is not only about producing code. 
A good project is a project that has a triving community producing improvement propositions, 
graphic assets, communication, translations, etc.

If you think you are not able to contribute because you cannot produce code: **DON'T**. Please...

Developers are not all-knowing people. They need to colaborate with people having multiple talents. 
Opening a ticket to raise a bug or ask for a feature is already a huge contribution. 
Translating text, propose interface improvement or draw graphics also are.

## If you don't know something, ask

It's ok to not know how to develop an Android application or to use `git`. 
Documentations are good assets if you know what you are searching for and 
how to formulate the question, but sometimes, it's not enough.

In such cases, it's really ok to ask. It's faster and easier and you can be guided. 
Never hesitate to seek help among other contributor. Life is all about learning!

# Technique

Before you start developing, you should install [Android studio](https://developer.android.com/studio/install), 
Android's, integrated development enrionment.

Read the [contributing section of the README](https://git.feneas.org/christophehenry/freshrss-android#contributing).

Pick [a ticket](https://git.feneas.org/christophehenry/freshrss-android/issues), 
preferably, on that is marked for the next release and start working on it.

Apart from application's features and development, this project is severely 
lacking tests and a good CI pipeline. Feel free to set them up if you feel 
you have the knowledge. 

# Contributors

## The community and the users

Thank you a lot for using this app, talking about it, loving it ❤️

## Translators

There are no translators yet. The whole application is in English. 
If you want to translate in your language feel free to do so. 
Read [Android's documentation on translations](https://developer.android.com/studio/write/translations-editor).
  
## UI Graphism

There are no graphists yet. If you think you can improve the look of the application 
please, submit propositions. We desperatly need you.

## UX

* Natouille

## Ticket openers

These section thanks the users opening ticket to raise bug or propose features

* [GLLM](https://git.feneas.org/GLLM)

And others: also thanks to you, anonymous ones that open only one and a fistful of tickets 
on the project. You, too, matter and deserve a thank you.

## Devs

* [Christophe](https://git.feneas.org/christophehenry)