Skip to content

api: swagger: fix documentation for image push endpoint#48443

Merged
thaJeztah merged 2 commits intomoby:masterfrom
thaJeztah:fix_push_docs
Sep 11, 2024
Merged

api: swagger: fix documentation for image push endpoint#48443
thaJeztah merged 2 commits intomoby:masterfrom
thaJeztah:fix_push_docs

Conversation

@thaJeztah
Copy link
Copy Markdown
Member

The documentation was incorrect and didn't properly document the use of tags;

  • Image push currently only accepts an image-name, not an ID / digest.
  • When giving a name, it's expected to be without tag included; when including a tag, it is ignored.
  • The tag parameter is required when pushing a single image (i.e., it does not default to "latest"); omitting the tag parameter will push all tags of the given image.

- Description for the changelog

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

@thaJeztah
Copy link
Copy Markdown
Member Author

Opening as draft, because I'm not really sold on the wording 😂 - once we get to better wording, I can update the versioned copies that are used in the docs.

cc @dvdksn perhaps you have good suggestions

Comment thread api/swagger.yaml Outdated
Comment thread api/swagger.yaml Outdated
Comment thread api/swagger.yaml Outdated
The documentation was incorrect and didn't properly document the use of
tags;

- Image push currently only accepts an image-name, not an ID / digest.
- When giving a name, it's expected to be without tag included; when
  including a tag, it is ignored.
- The tag parameter is required when pushing a single image (i.e., it
  does not default to "latest"); omitting the tag parameter will push
  all tags of the given image.

Signed-off-by: Sebastiaan van Stijn <[email protected]>
The documentation was incorrect and didn't properly document the use of
tags;

- Image push currently only accepts an image-name, not an ID / digest.
- When giving a name, it's expected to be without tag included; when
  including a tag, it is ignored.
- The tag parameter is required when pushing a single image (i.e., it
  does not default to "latest"); omitting the tag parameter will push
  all tags of the given image.

Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah marked this pull request as ready for review September 9, 2024 12:34
@thaJeztah
Copy link
Copy Markdown
Member Author

Updated; also updated the versioned files used in the docs

Copy link
Copy Markdown
Contributor

@dvdksn dvdksn left a comment

Choose a reason for hiding this comment

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

LGTM

@thaJeztah thaJeztah merged commit 47855a7 into moby:master Sep 11, 2024
@thaJeztah thaJeztah deleted the fix_push_docs branch September 11, 2024 08:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants