Skip to content

Latest commit

 

History

History
98 lines (61 loc) · 3.64 KB

CONTRIBUTING.md

File metadata and controls

98 lines (61 loc) · 3.64 KB

Contributing

Getting Started

This project adheres to the Contributor Covenant code of conduct. By participating in this project, you agree to abide by its terms.

First, create a fork of the open-wc/open-wc repository by hitting the fork button on the GitHub page.

Next, clone your fork onto your computer (replacing YOUR_USERNAME with your actual GitHub username).

git clone git@github.com:YOUR_USERNAME/open-wc.git

Once cloning is complete, change directory to the repository and add the Open Web Components project as a remote.

cd open-wc
git remote add upstream git@github.com:open-wc/open-wc.git

Preparing Your Local Environment for Development

Now that you have cloned the repository, ensure you have Node 18+ installed, then run the following command to set up the development environment.

npm install

This will download and install all packages needed.

Making Your Changes

First, update your fork with the latest code from upstream, then create a new branch for your work.

git checkout master
git pull upstream master --rebase
git checkout -b my-awesome-fix

Linting

Commits are linted using precommit hooks, meaning that any code that raises a linting error cannot be committed. In order to help avoid that, we recommend using an IDE or editor with an ESLint plugin in order to streamline the development process. Plugins are available for all the popular editors. For more information see ESLint Integrations

Running Tests

To run the tests of a package, it's recommended to cd into the package directory and then using npm test to run them. This way you're only running tests of that specific package.

Adding New Packages

For all projects, the tsconfig/jsconfig configuration files are auto-generated. You need to add an entry to the ./workspace-packages.mjs to let it generate a config for you. After adding an entry, run npm run update-package-configs to generate the files for you.

Creating a Changeset

If you made changes for which you want to trigger a release, you need to create a changeset. This documents your intent to release and allows you to specify a message that will be put into the changelog(s) of the package(s).

More information on changesets

To create a changeset, run:

npx changeset

Use the menu to select for which packages you need a release, and then select what kind of release. For the release type, we follow Semantic Versioning, so please take a look if you're unfamiliar.

In short:

  • A documentation change or similar chore usually does not require a release
  • A bugfix requires a patch
  • A new feature (feat) requires a minor
  • A breaking change requires a major

Exceptions:

  • For alpha (<1.0.0), bugfixes and feats are both patches, and breaking changes are allowed as minors.
  • For release-candidate and other special cases, other rules may follow.

Committing Your Changes

Commit messages must follow the conventional commit format. Open Web Components uses the package name as the scope. So for example if you fix a terrible bug in the package @open-wc/testing, the commit message should look like this:

fix(testing): fix terrible bug

Create a Pull Request

After you commit your changes, it's time to push your branch.

git push -u origin my-awesome-fix

After a successful push, visit your fork on GitHub. You should see a button that will allow you to create a pull request.