Skip to content

Commit

Permalink
chore: add CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mdonnalley committed Mar 18, 2024
1 parent 1ef5bf2 commit 5eae94f
Show file tree
Hide file tree
Showing 2 changed files with 76 additions and 1 deletion.
65 changes: 65 additions & 0 deletions CONRTIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Contributing

## Development

**1. Clone this repository...**

```bash
$ git clone [email protected]:oclif/plugin-update.git
```

**2. Navigate into project & install development-specific dependencies...**

```bash
$ cd ./plugin-update && yarn
```

**3. Write some code &/or add some tests...**

```bash
...
```

**4. Test changes locally**

To test using local dev script:

```
./bin/dev.js <command>
```

To test inside an existing oclif CLI (must have [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins) installed):

```
<CLI> plugins link --no-install
<CLI> <command>
```

See `plugins link` [documentation](https://github.com/oclif/plugin-plugins?tab=readme-ov-file#mycli-pluginslink-plugin)

**5. Run tests & ensure they pass...**

```
$ yarn test
```

**6. Open a [Pull Request](https://github.com/oclif/plugin-update/pulls) for your work & become the newest contributor to `@oclif/plugin-update`! 🎉**

## Pull Request Conventions

We use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). When opening a pull request, please be sure that either the pull request title, or each commit in the pull request, has one of the following prefixes:

- `feat`: For when introducing a new feature. The result will be a new semver minor version of the package when it is next published.
- `fix`: For bug fixes. The result will be a new semver patch version of the package when it is next published.
- `docs`: For documentation updates. The result will be a new semver patch version of the package when it is next published.
- `chore`: For changes that do not affect the published module. Often these are changes to tests. The result will be _no_ change to the version of the package when it is next published (as the commit does not affect the published version).

## What _not_ to contribute?

### Dependencies

It should be noted that our team does not accept third-party dependency updates/PRs. We use dependabot to ensure dependencies are staying up-to-date & will ship security patches for CVEs as they occur. If you submit a PR trying to update our dependencies we will close it with or without a reference to these contribution guidelines.

### Tools/Automation

Our core team is responsible for the maintenance of the tooling/automation in this project & we ask collaborators to kindly not make changes to these when contributing (ex. `.github/*`, `.eslintrc.json`, package.json `scripts`, etc.)
12 changes: 11 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@
- [@oclif/plugin-update](#oclifplugin-update)
- [Usage](#usage)
- [Commands](#commands)
- [`oclif-example update [CHANNEL]`](#oclif-example-update-channel)
- [Contributing](#contributing)
<!-- tocstop -->

# Usage
Expand All @@ -19,7 +21,11 @@ See https://oclif.io/docs/releasing.html#autoupdater

<!-- commands -->

- [`oclif-example update [CHANNEL]`](#oclif-example-update-channel)
- [@oclif/plugin-update](#oclifplugin-update)
- [Usage](#usage)
- [Commands](#commands)
- [`oclif-example update [CHANNEL]`](#oclif-example-update-channel)
- [Contributing](#contributing)

## `oclif-example update [CHANNEL]`

Expand Down Expand Up @@ -59,3 +65,7 @@ EXAMPLES
_See code: [src/commands/update.ts](https://github.com/oclif/plugin-update/blob/4.2.0/src/commands/update.ts)_

<!-- commandsstop -->

# Contributing

See [contributing guide](./CONRTIBUTING.md)

0 comments on commit 5eae94f

Please sign in to comment.