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

mark alpha command as experimental #10170

Merged
merged 1 commit into from
Jan 12, 2023
Merged

Conversation

ndeloof
Copy link
Contributor

@ndeloof ndeloof commented Jan 12, 2023

Mark experimental CLI commands with annotation so docs will reflect it
based on @thaJeztah comment #10163 (review)

@ndeloof ndeloof requested review from a team, nicksieger, StefanScherer, ulyssessouza, glours, milas and laurazard and removed request for a team January 12, 2023 13:04
Copy link
Contributor

@glours glours left a comment

Choose a reason for hiding this comment

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

👌

@@ -25,6 +25,10 @@ func alphaCommand(p *ProjectOptions, backend api.Service) *cobra.Command {
Short: "Experimental commands",
Use: "alpha [COMMAND]",
Hidden: true,
Annotations: map[string]string{
"experimental": "true",
Copy link
Member

Choose a reason for hiding this comment

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

I think we only need the experimentalCLI part, as this one may (not sure if that's implemented in compose) hide the command based on whether the daemon has experimental features enabled.

@@ -44,6 +44,10 @@ func watchCommand(p *ProjectOptions, backend api.Service) *cobra.Command {
return runWatch(ctx, backend, opts, args)
}),
ValidArgsFunction: completeServiceNames(p),
Annotations: map[string]string{
Copy link
Member

Choose a reason for hiding this comment

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

If "watch" is a subcommand of "alpha", then probably this isn't needed (but double check if I'm right); IIRC, we make the YAMLdocs check if parents are experimental, and make child-commands inherit that.

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
@ndeloof ndeloof force-pushed the experimental_annotations branch from 3c209f3 to f429fa8 Compare January 12, 2023 13:32
@codecov
Copy link

codecov bot commented Jan 12, 2023

Codecov Report

❗ No coverage uploaded for pull request base (v2@db267d8). Click here to learn what that means.
Patch has no changes to coverable lines.

Additional details and impacted files
@@          Coverage Diff          @@
##             v2   #10170   +/-   ##
=====================================
  Coverage      ?   73.89%           
=====================================
  Files         ?        2           
  Lines         ?      272           
  Branches      ?        0           
=====================================
  Hits          ?      201           
  Misses        ?       60           
  Partials      ?       11           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

@ndeloof ndeloof merged commit 8c07fa4 into docker:v2 Jan 12, 2023
@ndeloof ndeloof deleted the experimental_annotations branch January 12, 2023 13:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants