Skip to content

Latest commit

 

History

History
58 lines (35 loc) · 1.95 KB

CONTRIBUTING.md

File metadata and controls

58 lines (35 loc) · 1.95 KB

Contributing to Mitype

👏🎉 First off, thanks for taking the time to contribute! 🎉👏

The following is a set of guidelines for contributing to Mitype. These are mostly guidelines, not rules. Use your best judgment.

Table of Contents

Build and Run

Pull Requests

Styleguides

Code of Conduct

Build and Run

Read build document if you want to understand how mitype works or want to debug an issue and run it locally.

Pull Requests

  • All pull requests must have an issue linked with it. Please create an issue if it doesn't exist already before creating a pull request.
  • Creating an issue beforehand helps discuss bugs and enhancements before work begins, preventing wasted effort.
  • Comment on an issue if you are willing to work on it if no one else is assigned already.
  1. Follow the styleguides.

  2. Single feature or bug-fix per PR.

  3. Make your modification compact - don't reformat source code in your request. It makes code review more difficult.

Styleguides

Git Commit Messages

  • Use the present tense ("Add feature" not "Added feature")
  • Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
  • Do not end the title with full-stop
  • Limit the title to 72 characters or less
  • Leave one line empty after your title if the message has a body
  • Refer issues like "This fixes bug #ID" at the end of the body

Python Styleguide

All python code is linted with black.

  • Place imports in the following order:
    • Built-in Python Modules (such as os)
    • Mitype Modules (using relative paths)
  • Avoid platform-dependent code

Code of Conduct

While contributing to the project, it is very important to maintain a healthy environment! Hence I request you to follow the Code of Conduct.