File: content/manuals/enterprise/security/hardened-desktop/settings-management/_index.md
Issue
The policy precedence section uses confusing terminology that contradicts the ordering:
- User-specific policies: Highest priority
- Organization default policy: Applied when no user-specific policy exists
- Local
admin-settings.json file: Lowest priority, overridden by Admin Console policies
- 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:
- Clarify what "super-set" means in this context (e.g., "Configuration profiles include all Admin Console policy settings plus additional macOS-specific controls")
- Reorder the list if configuration profiles actually have higher priority
- Remove the term "super-set" and clearly state the precedence relationship
Found by nightly documentation quality scanner
File:
content/manuals/enterprise/security/hardened-desktop/settings-management/_index.mdIssue
The policy precedence section uses confusing terminology that contradicts the ordering:
Item 4 describes configuration profiles as a "super-set" of Admin Console policies, but lists them AFTER the local
admin-settings.jsonfile 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:
This confusion could lead administrators to misconfigure their policies or misunderstand which settings will actually be enforced.
Suggested fix
Either:
Found by nightly documentation quality scanner