Skip to content
This repository has been archived by the owner on Apr 14, 2021. It is now read-only.

Restore 2.0 deprecations #6933

Closed
wants to merge 7 commits into from
Closed

Conversation

deivid-rodriguez
Copy link
Member

@deivid-rodriguez deivid-rodriguez commented Jan 25, 2019

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

The problem was that deprecation messages for stuff we want to change in bundler 3 are not yet being displayed.

What was your diagnosis of the problem?

My diagnosis was that we need to make sure we enable deprecations as soon as possible.

What is your fix for the problem, implemented in this PR?

My fix includes several improvements regarding deprecations:

  • Change the deprecation strategy. Previously deprecations would be always hidden unless the user explicitly turn them on via configuration, or the user is running a "deprecation release", namely, a release with minor level version equal to 99. The new deprecation strategy is simpler: no deprecation releases, and deprecations are turned on by default unless the user turns them off. Moved to Turn on deprecations by default #6965 and targeted to master.

  • Move deprecations back to bundler 2. We moved them to bundler 3, but I think it's fine to deprecate all the stuff in bundler 2, and actually change the behavior in bundler 3. Exceptions are:

    • Prefering gems.rb and deprecating Gemfile. Because I think we decided to delay this due to the ommipresence of Gemfile's everywhere.
    • The one about executable mismatches, because I'm not sure I understand that one, how to reproduce it, and whether it should be a deprecation message or just a warning.
    • The ones about https by default and deprecated sources (github, and others). Because it's partially handled in Actually switch the default behavior of github sources. #6911 and I want to give that process some more thought.
  • Change deprecation message wording. Previous they would read "[DEPRECATED FOR 2.0] <Message about the deprecation>". I find the version in the message a bit confusing so I changed it to just "[DEPRECATED] <Message about the deprecation>". Moved to Turn on deprecations by default #6965 and targeted to master.

Why did you choose this fix out of the possible options?

I included all of the improvements in this PR because just moving back the deprecation horizon didn't really fix what I wanted to fix, namely, get the stuff really deprecated in the sense that end users get actual deprecation messages.

@deivid-rodriguez deivid-rodriguez force-pushed the restore_2.0_deprecations branch 2 times, most recently from 969d391 to 34a0cc3 Compare January 26, 2019 18:03
Use feature flag instead.
Only left the ones I'm not sure of, and that I think require more
thought.
But the check for the major version seems redundant.
@deivid-rodriguez
Copy link
Member Author

I'll now retarget this PR to master, including only the behavior changes (bullet points number 1 and 3 above).

@deivid-rodriguez
Copy link
Member Author

Moved bullet points 1 and 3 to #6965 and changed the description of this PR to reflect that.

@deivid-rodriguez
Copy link
Member Author

We'll most likely cut 2.1 from master, so I'm closing this.

@deivid-rodriguez deivid-rodriguez deleted the restore_2.0_deprecations branch April 3, 2019 12:25
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant