Skip to content

Latest commit

 

History

History
69 lines (53 loc) · 2.88 KB

CONTRIBUTING.md

File metadata and controls

69 lines (53 loc) · 2.88 KB
Raw

Contributing

We love your input! We want to make contributing to this project as easy and transparent as possible. If you wish to contribute please first discuss the change you wish to make via an issue, email, contact form at https://baserow.io/contact or any other method with us. If you do not know on what to contribute, please send us a small overview of your experience and optionally what you would like to learn. We will get back to you as soon as possible with proposed issues.

We develop with GitLab

We use GitLab to host code, to track issues and to make feature requests. The official repository can be found on https://gitlab.com/bramw/baserow/. There is a mirror repository on GitHub, but this is not the official one.

The merge request process

  1. You contact us and we will discuss which issue you can work on.
  2. Fork the repository and create a branch from develop.
  3. Make the changes described in the issue.
  4. Ensure that your code meets the quality standards.
  5. Submit your merge request!
  6. Usually we enable the following Gitlab merge options:
    1. "Delete source branch when merge request is accepted. "
    2. "Squash commits when merge request is accepted."
  7. A maintainer will review your code and merge your code.

Quality standards

  • Backend code must have unit tests.
  • Python code must be compliant with the PEP 8 standard.
  • In code Python docs must be in reStructured style.
  • SCSS code must be compliant with BEM.
  • Javascript code must be compliant with the eslint:recommended rules.
  • In code documentation is required for every function or class that is not self-evident.
  • Documentation for every concept that can used by a plugin.
  • changelog.md should be updated with any new features.
  • The pipeline must pass.

Any contributions you make will be under the MIT Software License

In short, when you submit code changes, your submissions are understood to be under the same MIT License that covers the project. Feel free to contact us if that is a concern.

Bug reports

We use GitLab issues to track public bugs. You can report a bug by opening a new issue at https://gitlab.com/bramw/baserow/-/issues. You may also send the bug to us via email or via the contact form at https://baserow.io/contact instead if you prefer.

Great Bug Reports tend to have:

  • A quick summary and/or background.
  • Steps to reproduce.
    • Be specific!
    • Give sample code if you can.
  • What you expected would happen.
  • What actually happens.
  • Notes (possibly including why you think this might be happening, or stuff you tried that did not work)

People love thorough bug reports.

Vulnerability

If you have found a vulnerability in Baserow we would appreciate it if you would notify us via email or via the contact form at https://baserow.io/contact instead of publicly as the vulnerability might need to be addressed first.