Skip to content

[docs-scanner] Inconsistent policy name for license compliance policy #25936

Description

@docker-agent

Files:content/manuals/scout/policy/_index.md, content/manuals/scout/policy/local.md

Issue

The same policy is referred to with different names across files in the same directory.

In _index.md (line 53):

Compliant Licenses

The Compliant Licenses policy type checks whether your images contain
packages distributed under an inappropriate license.

But in local.md (line 197):

| No copyleft licenses | Packages under AGPL, GPL, LGPL, MPL, and similar licenses |

And in the example (line 140):

$ docker scout policy myorg/app:latest --only-policy "No copyleft licenses"

Why this matters

A reader learning about Docker Scout policies would encounter "Compliant Licenses" in the overview documentation, but then see "No copyleft licenses" in the CLI evaluation guide and examples. This inconsistency makes it unclear whether these are the same policy or two different policies. When trying to use the --only-policy flag, readers won't know whether to use "Compliant Licenses" or "No copyleft licenses" as the policy name.

Suggested fix

Use consistent naming across both files. Determine which is the canonical policy name and use it consistently:

  • If "Compliant Licenses" is correct, update local.md to use that name
  • If "No copyleft licenses" is correct, update _index.md to use that name

The policy name should match what users need to pass to the --only-policy flag.


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions