Skip to content

Update contributing guidelines for clarity#12505

Merged
BagToad merged 1 commit intotrunkfrom
kw/contributing-guidelines-clarity
Jan 21, 2026
Merged

Update contributing guidelines for clarity#12505
BagToad merged 1 commit intotrunkfrom
kw/contributing-guidelines-clarity

Conversation

@BagToad
Copy link
Member

@BagToad BagToad commented Jan 20, 2026

This proposes a few quick clarity and brevity improvements to contributing guidelines. Also includes some small formatting adjustments.

@BagToad BagToad force-pushed the kw/contributing-guidelines-clarity branch 2 times, most recently from d7380c9 to 6e3871c Compare January 20, 2026 22:19
@BagToad BagToad force-pushed the kw/contributing-guidelines-clarity branch from 6e3871c to fe72908 Compare January 20, 2026 22:21
@BagToad BagToad marked this pull request as ready for review January 20, 2026 22:22
@BagToad BagToad requested a review from a team as a code owner January 20, 2026 22:22
@BagToad BagToad requested review from babakks and Copilot January 20, 2026 22:22
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the CONTRIBUTING.md guidelines to improve clarity and brevity. The changes simplify language and adjust formatting for consistency.

Changes:

  • Simplified contribution acceptance policy to focus on help wanted labeled issues
  • Generalized language from "significant change" to "change"
  • Updated formatting emphasis from "do not" to "do NOT"

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Member

@babakks babakks left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

* Check issues to verify that a [bug][bug issues] or [feature request][feature request issues] issue does not already exist for the same problem or feature
* Open an issue if things aren't working as expected
* Open an issue to propose a significant change
* Open an issue to propose a change
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wdyt about appending "(small or large)"?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So I was thinking we should remove the size wording here to remove subjectivity since it's challenging to describe what "small" or "large" might mean for us.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll merge this for now, but let's go and fix this if you want in another PR 👍

@BagToad BagToad merged commit c34c47c into trunk Jan 21, 2026
13 checks passed
@BagToad BagToad deleted the kw/contributing-guidelines-clarity branch January 21, 2026 16:50
tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Jan 22, 2026
This MR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [cli/cli](https://github.com/cli/cli) | minor | `v2.85.0` → `v2.86.0` |

MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).

**Proposed changes to behavior should be submitted there as MRs.**

---

### Release Notes

<details>
<summary>cli/cli (cli/cli)</summary>

### [`v2.86.0`](https://github.com/cli/cli/releases/tag/v2.86.0): GitHub CLI 2.86.0

[Compare Source](cli/cli@v2.85.0...v2.86.0)

#### :copilot:  Install and run GitHub Copilot CLI directly from `gh`

Since we deprecated the [GitHub Copilot in the CLI](https://github.blog/changelog/2025-09-25-upcoming-deprecation-of-gh-copilot-cli-extension/) extension in favor of the new agentic [GitHub Copilot CLI](https://github.com/github/copilot-cli), we want to give developers using `gh` a simple way to get started using our most powerful terminal assistant.

- `gh copilot` will prompt to install, then run Copilot CLI
- `gh copilot <args>` will execute the Copilot CLI, forwarding any arguments and flags

For more information and usage options, run `gh copilot --help`.

#### What's Changed

##### ✨ Features

- `gh copilot`: add native `copilot` command to execute/install copilot cli by [@&#8203;devm33](https://github.com/devm33) in [#&#8203;12444](cli/cli#12444)
- `gh cache delete`: allow for delete all caches for a ref by [@&#8203;davidspek](https://github.com/davidspek) in [#&#8203;12101](cli/cli#12101)
- `gh pr create`: error when head and base refs are identical in pr create by [@&#8203;majiayu000](https://github.com/majiayu000) in [#&#8203;12376](cli/cli#12376)

##### 📚 Docs & Chores

- Fix Windows asset URL in `copilot` command tests by [@&#8203;babakks](https://github.com/babakks) in [#&#8203;12500](cli/cli#12500)
- Update contributing guidelines for clarity by [@&#8203;BagToad](https://github.com/BagToad) in [#&#8203;12505](cli/cli#12505)

#### New Contributors

- [@&#8203;devm33](https://github.com/devm33) made their first contribution in [#&#8203;12444](cli/cli#12444)
- [@&#8203;davidspek](https://github.com/davidspek) made their first contribution in [#&#8203;12101](cli/cli#12101)

**Full Changelog**: <cli/cli@v2.85.0...v2.86.0>

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this MR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box

---

This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi44Ni4xIiwidXBkYXRlZEluVmVyIjoiNDIuODYuMSIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiUmVub3ZhdGUgQm90IiwiYXV0b21hdGlvbjpib3QtYXV0aG9yZWQiLCJkZXBlbmRlbmN5LXR5cGU6Om1pbm9yIl19-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants