CONTRIBUTING.md

Coopstarter's contributions guidelines

These guidelines are an extension of the Startin'blox guidelines.

See the documentation of the framework and contribute to the FAQ documentation if you're not able to find the answer you're looking for.

If you have any question left, come to meet us on community.startinblox.com

Reporting a bug or propose a new feature

Feel welcome to open an issue. Before submitting one, have a look on the already opened ones to avoid duplication. Templates are at your disposal for bug report or feature suggestion . They will help you describe your contribution properly. Be the more explicit you can in the title to help futures contributors.

Improve the code

Create your own branch

For each modification you want to propose, you must create a new branch.

Each branch must be related to one issue only.

We name our branches like this :

• feature/#140 (closed)
• bug/#141 (closed)

Where #140 (closed) and #141 (closed) is the number that refers to your issue or the issue you're solving

Take care of your commit messages

Please prefix your commit message with the level of modification which can be :

• feature for modification that add a significant new behavior to the software
• update for any modification of the behavior of the software that requires a specification update
• bugfix for any modification making the software comply with the specification
• ui for any modification of the software that affect its appearance but not its behavior
• syntax for any modification that do not affect the user, like a refactoring

Examples :

bugfix: set lookup field on @id
update: configurable fields (fix #6)
feature: representation of foreign keys as objects (fix #5)
feature: Federation model (fix #7)

These prefix are essential as they will trigger an automatic release for the component.

You can also add the id of the related issue, to link it automatically to the commit. (for the issue 12, add #12 in your commit message).