Skip to content
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

cli/command: remove deprecated DockerCliOption, InitializeOpt #4810

Merged
merged 1 commit into from
Jan 23, 2024

Conversation

thaJeztah
Copy link
Member

These types were deprecated in 7af509c (v25.0), in favor of CLIOption, and are no longer used.

This patch removes the deprecated type-aliases, and while updating, also improves the documentation for the CLIOption type.

With this patch:

Screenshot 2024-01-20 at 21 37 36

- What I did

- How I did it

- How to verify it

- Description for the changelog

cli/command: remove deprecated 1DockerCliOption`, `InitializeOpt`

- A picture of a cute animal (not mandatory but encouraged)

These types were deprecated in 7af509c (v25.0),
in favor of CLIOption, and are no longer used.

This patch removes the deprecated type-aliases, and while updating, also improves
the documentation for the CLIOption type.

Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah added this to the 26.0.0 milestone Jan 20, 2024
@thaJeztah thaJeztah self-assigned this Jan 20, 2024
@codecov-commenter
Copy link

codecov-commenter commented Jan 20, 2024

Codecov Report

Merging #4810 (b43377a) into master (f18a476) will not change coverage.
The diff coverage is n/a.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #4810   +/-   ##
=======================================
  Coverage   59.63%   59.63%           
=======================================
  Files         287      287           
  Lines       24777    24777           
=======================================
  Hits        14775    14775           
  Misses       9114     9114           
  Partials      888      888           

@thaJeztah thaJeztah requested a review from a team January 22, 2024 20:33
Copy link
Contributor

@krissetto krissetto left a comment

Choose a reason for hiding this comment

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

LGTM.

// CLIOption applies a modification on a DockerCli.
// CLIOption is a functional argument to apply options to a [DockerCli]. These
// options can be passed to [NewDockerCli] to initialize a new CLI, or
// applied with [DockerCli.Initialize] or [DockerCli.Apply].
Copy link
Contributor

@krissetto krissetto Jan 23, 2024

Choose a reason for hiding this comment

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

Just for clarity, could It make sense to mention here that it replaces the deprecated DockerCliOption/InitializeOpt types?

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 don't think we've done that before. We usually;

  • Deprecate in 1 release, and add aliases to the new location (to give users a pointer where to look for the new thing)
  • Remove in the release after.

Admitted; if we're gonna ramp up release cadence, then 1 release "deprecated' may potentially be too short. OTOH; if we move to Go modules, every major release is ... a major release, so technically "anything goes!"

@thaJeztah thaJeztah merged commit 69a4fcc into docker:master Jan 23, 2024
77 checks passed
@thaJeztah thaJeztah deleted the remove_deprecated_cliopts branch January 23, 2024 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants