Skip to content

[docs-scanner] Confusing policy precedence terminology in Settings Management #24967

@docker-agent

Description

@docker-agent

File: content/manuals/enterprise/security/hardened-desktop/settings-management/_index.md

Issue

The policy precedence section uses confusing terminology that contradicts the ordering:

  1. User-specific policies: Highest priority
  2. Organization default policy: Applied when no user-specific policy exists
  3. Local admin-settings.json file: Lowest priority, overridden by Admin Console policies
  4. Configuration profiles: Super-set of Docker Admin Console policies.

Item 4 describes configuration profiles as a "super-set" of Admin Console policies, but lists them AFTER the local admin-settings.json file which is explicitly marked as "lowest priority".

Why this matters

Readers trying to understand which policy takes precedence will be confused by this ordering. If configuration profiles are a "super-set", readers would expect them to have higher priority, not be listed last. The term "super-set" is also ambiguous - does it mean:

  • Higher priority?
  • More comprehensive (includes all Admin Console settings plus more)?
  • A different configuration method entirely?

This confusion could lead administrators to misconfigure their policies or misunderstand which settings will actually be enforced.

Suggested fix

Either:

  1. Clarify what "super-set" means in this context (e.g., "Configuration profiles include all Admin Console policy settings plus additional macOS-specific controls")
  2. Reorder the list if configuration profiles actually have higher priority
  3. Remove the term "super-set" and clearly state the precedence relationship

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/generatedarea/adminRelates to Docker Adminstatus/confirmedIssue triaged and confirmed as a real problem, ready to fix

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions