snabbdom/CONTRIBUTING.md

# Contributing

## Allowing CI builds of pull requests from forks

Some secrets are included as environment variables in the CI build.
Since code in forks is considered un-trusted,
CI builds of pull requests from forks are run without secrets.
This causes the CI build to fail.

To mark the HEAD of a pull request as trusted
— which would trigger a build that includes the secrets —
run the following command:

```sh
# `ORIGIN` is your remote name for the Snabbdom repository.
# `PR` is the pull request number
REF=refs/remotes/$ORIGIN/pull/$PR/head
git fetch $ORIGIN +refs/pull/$PR/head:$REF
BRANCH=allow-ci_$PR
git push $ORIGIN +${REF}:refs/heads/$BRANCH
```

After the pull request is merged or closed, delete the branch:

```sh
git push --delete $ORIGIN $BRANCH
```

## Making a release

Make sure you have permission to publish, by running

    npm access ls-collaborators

While on the `master` branch, switch to a new branch, possibly called `release`:

    git switch --create release
    npm run make-release-commit

Create a new pull request from this branch. The name of the pull request possibly identical to the commit message.

"Rebase and merge" the pull request.

    git switch master
    git pull

Where `$VERSION` is the new version, run

    git tag v$VERSION

For example:

    git tag v5.2.4

And then

    git push --tags
    npm publish