Skip to content

Latest commit

 

History

History
59 lines (34 loc) · 3.81 KB

CONTRIBUTING.md

File metadata and controls

59 lines (34 loc) · 3.81 KB
Raw

How to Contribute

This document makes the process for contributing to our website clear and answers some questions that you may have.

Please make sure that you have read the code of conduct before continuing.

Semantic Versioning

We follow semantic versioning. We release patch versions for bugfixes, minor versions for new features or non-essential changes, and major versions for any breaking changes. Every significant change is documented in the changelog file.

Branch Organization

We only use the main branch.

Bugs

Known Issues and Report

We are using GitHub Issues to keep track of bugs fix, and changes to be made to the application. We keep a close eye on this and try to make it clear when we have an internal fix in progress. Before filing a new task, try to make sure your problem doesn’t already exist.

Security Bugs

Please do not report security bugs in the public issues; go through the process outlined on the Security Policy.

Proposing a Change

If you intend to add new features or suggest major changes to this website, check first that your idea is not yet in our tracking issues list. If not, we recommend creating a new discussion first. This lets us reach an agreement on your proposal before you put significant effort into it. After it has been approved, please create new issue, and choose the correct template.

If you’re only fixing a bug, it’s fine to submit a pull request right away but we still recommend to file an issue detailing what you’re fixing. This is helpful in case we don’t accept that specific fix but want to keep track of the issue.

Contribution Prerequisites

  • You have the latest version of Node and Git installed
  • You will be working on one item at a time.
  • If you do not have it yet, fork the repository. Clone it if you will work locally.
  • If you have already forked and clone the repository, make sure that it is in sync with the upstream repository (Syncing a fork).
  • Run npm i to install the needed dependencies

Sending a Pull Request (PR)

We are monitoring for pull requests. We will review your pull request and either merge it, request changes to it, or close it with an explanation. We’ll do our best to provide updates and feedback throughout the process.

Before submitting a PR, please make sure the following is done:

  • Run npm dev, and test if the changes you are proposing are working correctly.
  • Run npm build, to check if the application build correctly.

When commiting your changes, we recommend the following command to be run:

  • Check again if your forked repository or your local copy is up to date with upstream. (Syncing a fork).
  • Resolve conflicts if any.
  • Commit and push your changes to your forked repository.

When your proposed changes are in the forked repository on GitHub:

  • Create your PR.
  • Make sure the title follows the conventional-changelog format, depending on what item or issue you have been working on. Failure to set this accordingly will cause your pull request to be discarded.

You will receive a notification and be informed when your PR is published on development, staging, or in production.