Authentication in Docker Hub API

[laurabutchko]

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

Other

Description

There are two separate Authentication sections—one in General and one in the API. Could the overall descriptions for each section be expanded upon to better differentiate what they should be used for and when?

The Personal Access Token in the General section is nested under Types, but in the API section, it is listed as an individual category.

Location

https://docs.docker.com/reference/api/hub/latest/#tag/authentication

Suggestion

For the PAT section, it would be nice to have consistency in how it is displayed in each section (for example, either nested in both, or a separate category in both).

[laurabutchko]

A second suggestion for the PAT section under API - could this be moved to where the deprecated "Create an authentication token" is located, as that specifically mentions PAT?