New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bundler 2 Release Checklist #6582

indirect opened this Issue Jun 14, 2018 · 1 comment



indirect commented Jun 14, 2018

It’s finally here! This is the checklist and countdown for releasing Bundler 2. The items listed here are probably each an entire issue or pull request by themselves, and this issue serves as a place to track those items. This issue is also a good place to discuss adding or removing items in this list.


  • Modify deprecation checker to print a warning on the deprecated version, and remove the feature entirely on the major after the deprecated version. #6586
  • Verify that with_clean_env still works but prints a warning, and stops working in Bundler 3
  • Move the implementation of with_clean_env to without_bundle_env, add docs for without_bundle_env.
  • Update with_clean_env warning to say something like "It turns out with_clean_env was confusing because it tried to do two different things. Please check the docs and use either with_original_env or without_bundle_env depending on what you need."


  • Install Bundler 1.x and 2.x, have an existing Rails 5.2 app continue to work without issues
  • Install only Bundler 2.x, have an existing Rails 5.2 app continue to work without issues on Bundler 1.x
  • Upgrade an existing Rails 5.2 app from Bundler 1 to 2, continue to run without issues
  • Run bundle init; echo 'gem "rails"' >> Gemfile; bundle install; bundle exec rails new .; bundle update --bundler to install Rails 5.2, generate a new app, bump to Bundler 2, and use Rails without issues
  • Deploy a Rails 5.2 app running Bundler 2 to Heroku without issues


  • Review and update man pages for 2.x
  • Review and update pages for 2.x
  • Review and update guides for 2.x
  • Review and update the doc/ directory for 2.x
  • Add a guide to on how to upgrade from 1.x to 2.x
  • Add a guide to for how to use Bundler 2 on Heroku
  • Give a huge header-level toggle between 1.x and 2.x docs

Announce the release schedule

  • Prereleases for 4 weeks
  • Release RC, fix reported issues, release new RC
  • Final release is the first RC with no reported blockers for 2 weeks

Publish blog posts

  • One blog post covering a breaking change each week
  • In every post:
    • Re-explain the release schedule
    • Link to the 1.x to 2.x upgrade guide
    • Ask for testers to report issues

This comment has been minimized.


rubymorillo commented Jun 14, 2018

Here to help with docs and blog posts, @indirect. Let's discuss timeline, scope, and other needs a bit more so I can prep for it!

@colby-swandale colby-swandale self-assigned this Jun 17, 2018

bundlerbot added a commit that referenced this issue Jun 21, 2018

Auto merge of #6586 - bundler:segiddins/softer-major-deprecations, r=…

[SharedHelpers] Only hard-error on major deprecations in the following version

### What was the end-user problem that led to this PR?

The problem was, actually I'm not sure. @indirect ?

Addresses the first bullet point in #6582.

### What was your diagnosis of the problem?

My diagnosis was we should only hard error on deprecations in the major version _after_ we stop supporting them.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment