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

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions