Skip to content

Commit f22056b

Browse files
authored
Merge pull request #9594 from ruby/docs-discussions-and-versioning
Update contribution docs
2 parents a1c75ba + db38da8 commit f22056b

2 files changed

Lines changed: 5 additions & 5 deletions

File tree

doc/NEW_FEATURES.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22

33
## Substantial Features
44

5-
To request substantial changes to Bundler or Bundler documentation, please refer to the [RFC repository](https://github.com/rubygems/rfcs). See the [README](https://github.com/rubygems/rfcs/blob/master/README.md) for detailed instructions on the RFC process.
5+
To request substantial changes to Bundler or Bundler documentation, please start a discussion in [GitHub Discussions](https://github.com/rubygems/rubygems/discussions).
66

77
## Contributing New Features
88

99
To add a new feature to Bundler:
1010

11-
1. **Discuss your idea** - [Open an issue](https://github.com/ruby/rubygems/issues/new) to discuss your proposed feature
12-
2. **Base on master branch** - We follow [SemVer](https://semver.org), so new features go in the master branch only, not old releases
11+
1. **Discuss your idea** - If the goal is already clear, link the existing [issue](https://github.com/rubygems/rubygems/issues) or [discussion](https://github.com/rubygems/rubygems/discussions) that covers it. Otherwise, post your idea in [GitHub Discussions](https://github.com/rubygems/rubygems/discussions) first so it can be talked through
12+
2. **Base on master branch** - Substantial new features go in the master branch only. Releases follow a rational versioning policy: major versions may break existing code, minor versions can change behavior or output while keeping existing functionality working, and tiny versions are mostly bug fixes that may include feature additions
1313
3. **Write tests** - Include at least one test covering your changes in your feature branch
1414
4. **Submit a pull request** - See [PULL_REQUESTS.md](PULL_REQUESTS.md) for detailed guidelines
1515

doc/POLICIES.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -93,9 +93,9 @@ avoid breaking things, and we may even intentionally introduce this kind of
9393
cases. So be aware when using internals and ideally get in touch with us
9494
before doing so, so that we can help find the right APIs.
9595

96-
## RFC guidelines
96+
## Discussing large changes
9797

98-
Large changes often benefit from being written out more completely, read by others, and discussed. The [Bundler RFC repo](https://github.com/rubygems/rfcs) is the preferred place for that to happen.
98+
Large changes often benefit from being written out more completely, read by others, and discussed. [GitHub Discussions](https://github.com/rubygems/rubygems/discussions) is the preferred place for that to happen.
9999

100100
## Committer Access
101101

0 commit comments

Comments
 (0)