Skip to content

[docs-scanner] Python migration example missing authentication details #24743

@docker-agent

Description

@docker-agent

File: content/manuals/dhi/migration/examples/python.md

Issue

The authentication note in the Python migration example is incomplete compared to the Go and Node.js examples in the same directory. It's missing critical information about what credentials to use and how to create an account.

Current text in python.md:

You must authenticate to dhi.io before you can pull Docker Hardened Images. Run docker login dhi.io to authenticate.

Text in go.md and node.md:

You must authenticate to dhi.io before you can pull Docker Hardened Images. Use your Docker ID credentials (the same username and password you use for Docker Hub). If you don't have a Docker account, create one for free.

Run docker login dhi.io to authenticate.

Why this matters

A reader following the Python migration example won't know:

  1. What credentials to use for docker login dhi.io (Docker ID credentials)
  2. That these are the same credentials as Docker Hub
  3. How to create an account if they don't have one

This creates an incomplete user experience where Python users get less guidance than Go or Node.js users for the exact same authentication step.

Suggested fix

Update the NOTE block in content/manuals/dhi/migration/examples/python.md to match the complete version used in go.md and node.md:

> [!NOTE]
>
> Multi-stage builds are recommended for most use cases. Single-stage builds are
> supported for simplicity, but come with tradeoffs in size and security.
>
> You must authenticate to `dhi.io` before you can pull Docker Hardened Images.
> Use your Docker ID credentials (the same username and password you use for
> Docker Hub). If you don't have a Docker account, [create
> one](../../../accounts/create-account.md) for free.
>
> Run `docker login dhi.io` to authenticate.

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions