Fixed ticket 486, start to explain how to contribute.
This commit is contained in:
parent
07b2b2f305
commit
a2297decfd
115
CONTRIBUTE.mdtext
Normal file
115
CONTRIBUTE.mdtext
Normal file
@ -0,0 +1,115 @@
|
|||||||
|
[Indefero][idf] is not only a software you can use either hosted for
|
||||||
|
you or hosted by you, but also a free software you can contribute to.
|
||||||
|
|
||||||
|
Here you will get how to contribute and what to contribute.
|
||||||
|
|
||||||
|
[idf]: http://www.indefero.net
|
||||||
|
|
||||||
|
# Quick Way on How to Contribute
|
||||||
|
|
||||||
|
Simple contribution:
|
||||||
|
|
||||||
|
1. Open a ticket with your idea. You can directly propose a patch if
|
||||||
|
you have it.
|
||||||
|
|
||||||
|
2. Wait for it to be checked by the devs or meet us on the #indefero
|
||||||
|
channel on [FreeNode][freenode].
|
||||||
|
|
||||||
|
Bigger contribution:
|
||||||
|
|
||||||
|
1. Fork Indefero where you want (fork from the develop branch).
|
||||||
|
|
||||||
|
2. Code your change and document it.
|
||||||
|
|
||||||
|
3. Open a ticket with a pull request and talk about it on IRC.
|
||||||
|
|
||||||
|
# The General Contribution Workflow for Regular Contributors
|
||||||
|
|
||||||
|
1. Fork Indefero from the **develop** branch.
|
||||||
|
2. Request a pull request if you do not have write access on the repository.
|
||||||
|
3. Merge your changes without fast forward in develop. This keeps track of
|
||||||
|
the history of the changes and makes understanding what is going on easy.
|
||||||
|
4. Merge your changes with fast forward **only if a single commit**.
|
||||||
|
|
||||||
|
Indefero is composed of two main branches:
|
||||||
|
|
||||||
|
1. **master**: this is the shipped branch, only a select number of people
|
||||||
|
can push into it.
|
||||||
|
2. **develop**: this is the development branch, all the people having write
|
||||||
|
access to the repository are welcomed to push in.
|
||||||
|
|
||||||
|
**Note:** The branching model we use is [explained in details here][bmi]. You
|
||||||
|
**must** understand it to really contribute to the code base in an
|
||||||
|
efficient way.
|
||||||
|
|
||||||
|
[bmi]: http://nvie.com/git-model "A successful Git branching model"
|
||||||
|
|
||||||
|
# What to Contribute
|
||||||
|
|
||||||
|
Contribution is easy, you can contribute in a lot of different fields,
|
||||||
|
contributions small or big are always appreciated. Here is an example
|
||||||
|
list of what you can do:
|
||||||
|
|
||||||
|
- Install InDefero on your system and report the problem you had.
|
||||||
|
- Find the bad English and typos and propose corrections.
|
||||||
|
- Help with the translation effort.
|
||||||
|
- Find little bugs or usability problems and provide ideas on how to fix them.
|
||||||
|
- Register to the [discussion group][group] and help new users.
|
||||||
|
- Come and chat on IRC #indefero on the [FreeNode][freenode] servers.
|
||||||
|
- Find ways to improve the design while keeping it **beautifully simple**.
|
||||||
|
- Write a blog post about the project, what you think is good or bad.
|
||||||
|
- Translate InDefero for the sake of the community.
|
||||||
|
- Or maybe really hack into the code.
|
||||||
|
|
||||||
|
As you can see, the real hacking into the code is just a small part of the work, so even if you are not a coder you can do a lot.
|
||||||
|
|
||||||
|
[group]: http://groups.google.com/group/indefero-users
|
||||||
|
[freenode]: http://freenode.net/
|
||||||
|
|
||||||
|
## I am a simple user
|
||||||
|
|
||||||
|
Thanks a lot! Really! As a project leader, I consider **you** as
|
||||||
|
**the most important person in the success of the project**. So do not
|
||||||
|
worry, I will really listen to your needs and make you love this
|
||||||
|
project.
|
||||||
|
|
||||||
|
What you can do to help:
|
||||||
|
|
||||||
|
- Use the software and each time you find something a bit annoying in your daily use, report a bug. Usability issues are high priority issues.
|
||||||
|
- Find typos, grammar mistakes, etc. and report a bug.
|
||||||
|
- Write about InDefero on your blog/website.
|
||||||
|
- Read the issues submitted by the users and provide answers if you have them.
|
||||||
|
- ...
|
||||||
|
|
||||||
|
## I am a designer
|
||||||
|
|
||||||
|
A lot of things to do for you:
|
||||||
|
|
||||||
|
- Check the design and find the flaws in it. Is the space well used, does it look really nice and is it also functional for the first users?
|
||||||
|
- Do we have good support of all the major browsers?
|
||||||
|
- ...
|
||||||
|
|
||||||
|
## I am a coder
|
||||||
|
|
||||||
|
Checkout the code and have fun, but keep in mind that your results
|
||||||
|
must be simple to use. Do not worry about the beautiful part, the
|
||||||
|
designers can work on that.
|
||||||
|
|
||||||
|
## I am a security guy
|
||||||
|
|
||||||
|
Please, do try to break it, if you find a problem, come on IRC or
|
||||||
|
contact the developers to get the issue fixed as soon as
|
||||||
|
possible. Please, be nice, do not release the issue in the wild
|
||||||
|
without first talking to us.
|
||||||
|
|
||||||
|
## I am a translator
|
||||||
|
|
||||||
|
We currently use (transifex)[http://trac.transifex.org] to help our
|
||||||
|
users to translate indefero. You don't have to use it, but it's an
|
||||||
|
easy way to do the job. You can visit the indefero page at transifex
|
||||||
|
here : http://www.transifex.net/projects/p/indefero/c/indefero/
|
||||||
|
|
||||||
|
Please understand that your changes will not be commited instantly,
|
||||||
|
but are sent to the maintainers e-mails before. Then, your changes
|
||||||
|
will not be in the main repository until da-loic push the changes. In
|
||||||
|
that way, try to do big changes with less submissions.
|
Loading…
Reference in New Issue
Block a user