Skip to content
This repository has been archived by the owner on Jun 1, 2024. It is now read-only.

Latest commit

 

History

History
136 lines (93 loc) · 6.2 KB

CONTRIBUTING.md

File metadata and controls

136 lines (93 loc) · 6.2 KB
Raw

Contributing Guide

This is Beagle's contributing guide. You will find here some resources to help you contribute.

Table of contents

1. Before you contribute

1.1. Code of Conduct

1.2. Legal

2. Prerequisites

2.1. Pull Request title

2.2. Developer Certificate of Origin

3. How to contribute?

3.1. How can you contribute?

3.2. Contribution Guideline

3.3. Pull Request's approval

4. Community

Before you contribute

Code of Conduct

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

Legal

Prerequisites

Check out the requisites before contributing to Beagle:

Pull Request title

When opening a PR, add the title with a prefix of the type of change you are contributing, for example feat: for a new feature. You can see other types in the How can you contribute? section.

Your Pull Request should look like this:

feat: add field in component image to allow resizing

This format is called conventional commits. It helps us understand what each modification is actually doing, and allow us to automatically generate better release notes and versions.

For more information, please read the official specifications.

Developer Certificate of Origin - DCO

This is a security layer for the project and for the developers. It is mandatory.

Follow one of these two methods to add DCO to your commits:

1. Command line Follow the steps: Step 1: Configure your local git environment adding the same name and e-mail configured at your GitHub account. It helps to sign commits manually during reviews and suggestions.

git config --global user.name “Name”
git config --global user.email “[email protected]”

Step 2: Add the Signed-off-by line with the '-s' flag in the git commit command:

$ git commit -s -m "This is my commit message"

2. GitHub website You can also manually sign your commits during GitHub reviews and suggestions, follow the steps below:

Step 1: When the commit changes box opens, manually type or paste your signature in the comment box, see the example:

Signed-off-by: Name < e-mail address >

For this method, your name and e-mail must be the same registered on your GitHub account.

How to contribute?

See the guidelines to submit your changes.

How can you contribute?

You can contibute with a new feature, bug fix, documentation and more, check out below:

  • feat: A new feature (adding a new component, providing new variants for an existing component, etc.).
  • fix: A bug fix (correcting a styling issue, addressing a bug in a component's API, etc.). When updating non-dev dependencies, mark your changes with the fix: type.
  • docs: Documentation-only changes.
  • style: Changes that do not affect the meaning of the code (whitespace, formatting, missing semicolons, etc). Not to be used for CSS changes as those are meaningful changes, consider using feat: of fix: instead.
  • refactor: A code change that neither fixes a bug nor adds a feature.
  • perf: A code change that improves performance.
  • test: Adding missing tests or correcting existing tests.
  • build: Changes that affect the build system (changing webpack or Rollup config for example).
  • ci: Changes to our CI configuration files and scripts (changing Fastlane, adding or changing Danger plugins, etc.).
  • chore: Other changes that don't modify source or test files. Use this type when adding or updating dev dependencies.
  • revert: Reverts a previous commit.

Note: If you're introducing a breaking change, the message body should start with BREAKING CHANGE:.

Contribution Guideline

Follow the Pull Request submission guidelines below:

Step 1. Search for issues and PRs that relate to your submission to avoid duplication;

Step 2. Make sure that the issue describes the problem you're fixing, or documents the design for the feature you'd like to add. Discussing the design upfront helps to ensure that we're ready to accept your work.

Step 3. git clone this repository;

Step 4. Make your changes in a new git branch.

Step 5. Follow our Coding Rules;

Step 6. Commit your changes using a descriptive commit message, Signing all your commits and making sure to include appropriate test cases.=;

Step 7. Push your branch to GitHub;

Step 8. In GitHub, send a pull request to beagle:main;

Pull Request's approval

After Beagle's team analyze your contribution, we may add some questions and suggestions, you should:

  • Make the required updates.

  • Re-run Beagle's test suites and CI workflows to ensure everything is still working properly.

  • Rebase your branch and force push to your GitHub repository (this will update your Pull Request):

    git rebase main -i
git push -f

Community

  • Do you have any question about Beagle? Let's chat in our forum.

Thank you for your contribution!