Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
46 lines (28 loc) · 2.57 KB

CONTRIBUTING.md

File metadata and controls

46 lines (28 loc) · 2.57 KB

Contributing

Thank you for your interest in contributing to this repository! To ensure a smooth and collaborative process, please follow these guidelines.

Before You Start

Before making any changes, please discuss the proposed change with the repository owners. You can do this via an issue, email, or any other communication method.

Code of Conduct

Please adhere to our Code of Conduct in all your interactions with the project.

Internationalization (I18N)

All contributions should be in English to ensure that all members of the community can understand and contribute to the project. Translations can be provided in addition to the English version. It is recommended to use the ISO 639-1 standard for language codes.

Documentation

Documentation is mandatory for all contributions, including code, issues, and pull requests. The documentation should be:

  • Clear and concise
  • Written in Markdown format
  • Included in the README.md file at the root of the project
  • Additional documentation can be added to the docs folder

Commit Messages

All commit messages should follow the Conventional Commits format. This format ensures that the commit messages are easy to read and follow a consistent structure.

The use of emojis in commit messages is encouraged to make the messages more engaging and easier to understand.

Git strategy

All contributions should follow the GitFlow branching model. The main branches are:

  • main: The main branch for the project. This branch should always be stable and deployable.
  • develop: The development branch for the project. All feature branches should be merged into this branch.
  • feature/*: Feature branches for new functionality. These branches should be merged into the develop branch.
  • hotfix/*: Hotfix branches for critical bug fixes. These branches should be merged into the main and develop branches.
  • release/*: Release branches for preparing a new release. These branches should be merged into the main and develop branches.
  • support/*: Support branches for long-term support. These branches should be merged into the main branch.
  • docs/*: Documentation branches for updating the documentation. These branches should be merged into the main branch.

By following these guidelines, you help ensure that the project remains well-organized, accessible, and collaborative. Thank you for your contributions!