Docker.github.io: Please update this documentation!

Created on 16 Aug 2020  路  1Comment  路  Source: docker/docker.github.io

File: compose/aspnet-mssql-compose.md

There are a lot of steps missing, out of order, and much of it is out of date. Please update this to .net core 3, and add in the steps to include the proper references, and put the reference additions before the code they are needed for!

Most helpful comment

The documentation for listing /tags seems out of date.
I encountered problems using GET /v2/<name>/tags/list as stated in https://docs.docker.com/registry/spec/api/#listing-image-tags

Example:
GET https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags/list
returns

{
txnid: "REPOSREQ-cafbce86-5b8d-4051-91a3-e3dddc028fe9",
message: "tag 'list' not found",
errinfo: {
api_call_docker_id: "",
api_call_name: "GetRepositoryTag",
api_call_start: "2020-08-17T21:30:50.540228295Z",
api_call_txnid: "REPOSREQ-cafbce86-5b8d-4051-91a3-e3dddc028fe9",
namespace: "perconalab",
repository: "percona-server-mongodb-operator",
tag: "list"
}
}

and GET https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags returns

count: 615,
next: "https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags?page=2",
previous: null,
results: [
{
...

Seems like /tags is the way to go and /tags/list is legacy, but the docs do not reflect that.
Please clarify this information and update the docs accordingly

>All comments

The documentation for listing /tags seems out of date.
I encountered problems using GET /v2/<name>/tags/list as stated in https://docs.docker.com/registry/spec/api/#listing-image-tags

Example:
GET https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags/list
returns

{
txnid: "REPOSREQ-cafbce86-5b8d-4051-91a3-e3dddc028fe9",
message: "tag 'list' not found",
errinfo: {
api_call_docker_id: "",
api_call_name: "GetRepositoryTag",
api_call_start: "2020-08-17T21:30:50.540228295Z",
api_call_txnid: "REPOSREQ-cafbce86-5b8d-4051-91a3-e3dddc028fe9",
namespace: "perconalab",
repository: "percona-server-mongodb-operator",
tag: "list"
}
}

and GET https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags returns

count: 615,
next: "https://hub.docker.com/v2/repositories/perconalab/percona-server-mongodb-operator/tags?page=2",
previous: null,
results: [
{
...

Seems like /tags is the way to go and /tags/list is legacy, but the docs do not reflect that.
Please clarify this information and update the docs accordingly

Was this page helpful?
0 / 5 - 0 ratings

Related issues

jamshid picture jamshid  路  3Comments

johnthagen picture johnthagen  路  3Comments

GPPassos picture GPPassos  路  3Comments

joaofnfernandes picture joaofnfernandes  路  3Comments

DanJ210 picture DanJ210  路  3Comments