Skip to content

Latest commit

 

History

History
84 lines (55 loc) · 3.29 KB

CONTRIBUTING.md

File metadata and controls

84 lines (55 loc) · 3.29 KB
Raw

How to contribute to Dolibarr

Bug reports and feature requests

Note: Issues are not a support forum. If you need help using the software, please use the forums.

NEW

Issues are now managed on GitHub.

  1. Please use the search engine to check if nobody's already reported your problem.
  2. Create an issue. Choose an appropriate title. Prepend appropriately with Bug or Feature Request.
  3. Report with as much detail as possible (Use screenshots or even screencasts whenever possible).

We're still figuring out how to migrate old issues to GitHub. In the meantime, they are still available at Doliforge.

Code

Basic workflow

  1. Fork the GitHub repository.
  2. Clone your fork.
  3. Choose a branch(See the Branches section below).
  4. Commit and push your changes.
  5. Make a pull request.

Branches

Unless you're fixing a bug, all pull requests should be made against the develop branch.

If you're fixing a bug, it is preferred that you cook your fix and pull request it against the oldest version affected that's still supported.

We officially support versions N, N − 1 and N − 2 for N the latest version available.

Choose your base branch accordingly.

General rules

Please don't edit the ChangeLog file. A project manager will update it from your commit messages.

Commits

Use clear commit messages with the following structure:

FIX|Fix #456 Short description (where #456 is number of bug fix, if it exists. In upper case to appear into ChangeLog)
or
CLOSE|Close #456 Short description (where #456 is number of feature request, if it exists. In upper case to appear into ChangeLog)
or
NEW|New Short description (In upper case to appear into ChangeLog, use this if you add a feature not tracked, otherwise use CLOSE #456)
or
Short description (when the commit is not introducing feature nor closing a bug)

Long description (Can span accross multiple lines).

Pull Requests

When submitting a pull request, use same rule than Commits. With upper case keyword to appear into ChangeLog.

Resources

Developer documentation

Translations

The source language (en_US) is maintained in the repository. See the Code section above.

All other translations are managed online at Transifex.

Join an existing translation team or create your own and translate into the interface.

Your translations will be available in the next major release.

Resources

Translator documentation

Documentation

The project's documentation is maintained on the Wiki.

You need to create an account before being able to edit.