docs icon indicating copy to clipboard operation
docs copied to clipboard
verified publisher icon docker

[docker-hub-api] add list namespace repositories endpoint

Open vdamery opened this issue 6 months ago • 1 comments

Description

  • Add "new" list repositories in a given namespace endpoint : GET /v2/namespaces/{namespace}/repositories

After the comments from @thaJeztah

  • Split DVP Data API and Docker Hub API for better visiblity
  • Standardize sub entries in the side menu : Changelog, Deprecated and OpenAPI
  • Deprecated is now a table like in https://docs.docker.com/engine/deprecated/

Related issues or tickets

  • https://github.com/docker/hub-feedback/issues/2357

Reviews

  • [x] Technical review
  • [ ] Editorial review
  • [ ] Product review

vdamery avatar Jun 27 '25 10:06 vdamery

Deploy Preview for docsdocker ready!

Name Link
Latest commit 6628c25840cda15b705408cb675110080beac86c
Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/686f92838c1bb000080e9c07
Deploy Preview https://deploy-preview-22934--docsdocker.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify[bot] avatar Jun 27 '25 10:06 netlify[bot]

https://deploy-preview-22934--docsdocker.netlify.app

OpenAPI is confusing and not intuitive for navigation. It should say "Latest" to align with the drop down nav in Engine API. Also, I think the latest version of the API should come first, followed by Changelog, followed by Deprecated.

As for the /reference/api/dvp/, we have those pages set to render: never. I think to align on a repeated pattern, we add a landing page like the Engine API's _index.md file has.

sarahsanders-docker avatar Jul 09 '25 15:07 sarahsanders-docker

As @sarahsanders-docker and @thaJeztah suggested :

  • Renamed OpenAPI to Latest
  • Change order to : Latest thenChangelog then Deprecated

For the /reference/api/dvp/, I'm ok to add a proper description/page but I would need some wording for a such big page. cc @sheltongraves In production, https://docs.docker.com/reference/api/hub/ and https://docs.docker.com/reference/api/dvp/ returns 404 so maybe we can make those work in an other PR than this one. We have an initiative to update more this documentation now so there will be more PRs coming.

vdamery avatar Jul 10 '25 10:07 vdamery