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

Open
indirect opened this Issue Jun 14, 2018 · 1 comment

Comments

@indirect
Member

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.

Deprecations

  • 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."

Compatibility

  • 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

Documentation

  • Review and update man pages for 2.x
  • Review and update bundler.io pages for 2.x
  • Review and update bundler.io guides for 2.x
  • Review and update the doc/ directory for 2.x
  • Add a guide to bundler.io on how to upgrade from 1.x to 2.x
  • Add a guide to bundler.io for how to use Bundler 2 on Heroku
  • Give bundler.io 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
@rubymorillo

This comment has been minimized.

Contributor

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=…
…indirect

[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