File: content/manuals/dhi/how-to/customize.md
Issue
In the Docker Hub tab of the customization instructions, the documentation states:
When combining images that contain directories and files with the same path, images later in the list will overwrite files from earlier images. To manage this, you must select paths to include and optionally exclude from each OCI artifact image.
The phrase "images later in the list" assumes readers understand what "the list" refers to, but the Docker Hub UI instructions don't establish this ordering concept. The preceding text says "select the repository" and "select the tag" but doesn't explain that multiple OCI artifacts can be added or that they have an ordering.
Why this matters
A reader following the Docker Hub instructions would be confused by "later in the list" because:
- The UI workflow hasn't established that you can add multiple OCI artifacts
- There's no mention of how ordering is determined or controlled in the UI
- The CLI and Terraform tabs make ordering clearer (arrays, resource definitions), but the UI tab doesn't
This creates a comprehension gap where readers understand the consequence (later overwrites earlier) but not the mechanism (how to control ordering in the UI).
Suggested fix
Add context before the overwriting explanation:
You can add multiple OCI artifact images to a customization. When combining images that contain directories and files with the same path, images added later will overwrite files from images added earlier. To manage this, you must select paths to include and optionally exclude from each OCI artifact image.
Or restructure to explain the UI mechanism:
The OCI artifacts drop-down lets you add multiple artifact images. If you add multiple artifacts, they're applied in the order you add them. Files from later artifacts overwrite files from earlier artifacts when paths conflict. To control which files are included, select specific paths to include and optionally exclude from each artifact.
Found by nightly documentation quality scanner
File:
content/manuals/dhi/how-to/customize.mdIssue
In the Docker Hub tab of the customization instructions, the documentation states:
The phrase "images later in the list" assumes readers understand what "the list" refers to, but the Docker Hub UI instructions don't establish this ordering concept. The preceding text says "select the repository" and "select the tag" but doesn't explain that multiple OCI artifacts can be added or that they have an ordering.
Why this matters
A reader following the Docker Hub instructions would be confused by "later in the list" because:
This creates a comprehension gap where readers understand the consequence (later overwrites earlier) but not the mechanism (how to control ordering in the UI).
Suggested fix
Add context before the overwriting explanation:
Or restructure to explain the UI mechanism:
Found by nightly documentation quality scanner