CONTRIBUTING.md 1.5 KB
Newer Older
Thomas Frion's avatar
Thomas Frion committed
1
2
# Contributing rules

Thomas Frion's avatar
Thomas Frion committed
3
4
5
## Git

### Commit name
Thomas Frion's avatar
Thomas Frion committed
6
7
8
9
10
11

The commit name should be a summary of what you did. It should be accompanied by a description detailing what you did, any problems you encountered, and what remains to be done.

Each commit must have a name that starts with the following elements:

* `[FEAT]` For a new feature
Thomas Frion's avatar
Thomas Frion committed
12
* `[FILE]` For a new file or for an update of a file (not source code)
Thomas Frion's avatar
Thomas Frion committed
13
14
15
16
* `[CPNT]` For a new component
* `[UPDF]` For a feature update
* `[UPDC]` For a feature component
* `[FIX]`  For a bug fix
Thomas Frion's avatar
Thomas Frion committed
17
18
* `[CLEAN]` For refactoring or deleting unnecessary comments
* `[COMMENT]` For adding comment
Alexandra Chaton's avatar
Alexandra Chaton committed
19
* `[DOC]` For new documentation file or update of the documentation
Thomas Frion's avatar
Thomas Frion committed
20
21


Thomas Frion's avatar
Thomas Frion committed
22
### Branch name
Thomas Frion's avatar
Thomas Frion committed
23
24
25

A branch must be created by functionality, component, issue.

Thomas Frion's avatar
Thomas Frion committed
26
27
If the branch to be created is linked to an issue, then the name of the branch must start with the issue id.

Thomas Frion's avatar
Thomas Frion committed
28
### CHANGLOG
Thomas Frion's avatar
Thomas Frion committed
29

Thomas Frion's avatar
Thomas Frion committed
30
31
When you have finished working, you must fill in the changelog with the current date. The changelog should list the main changes and anything else you think is relevant.

Thomas Frion's avatar
Thomas Frion committed
32
### Issues
Thomas Frion's avatar
Thomas Frion committed
33
34
35
36
37
38

When you create a new issue, please add the right labels.

* `Back-end`      If this is about the back-end
* `Front-end`     If this is about the front-end
* `Documentation` If this is about the documentation
Thomas Frion's avatar
Thomas Frion committed
39
40
41
42
43
44
45
46
47
* `Bugs`          If this is a bug or any trouble

## Code

### Backend

#### API 

* If you add an new resource to the REST API, please create a new submodule with `$ python manage.py startapp <resource_name>`. You can use as sample the existing submodules.