Skip to content

[docs-scanner] Group Policy deployment instructions lack registry key structure details #24946

@docker-agent

Description

@docker-agent

File: content/manuals/enterprise/security/enforce-sign-in/methods.md

Issue

The "Group Policy deployment" tab for Windows registry key method tells administrators to "Create a registry script with the required key structure" but doesn't show what that structure is or reference where to find it.

Current instruction:

  1. Create a registry script with the required key structure.

The registry key structure is shown in the "Manual setup" tab, but the Group Policy tab doesn't reference it or provide the information administrators need to create the script.

Why this matters

Administrators following the Group Policy deployment instructions would need to:

  • Switch to the Manual setup tab to find the registry key structure
  • Translate that manual setup information into a Group Policy registry script
  • Guess at the correct format without explicit guidance

This creates unnecessary friction and potential for errors in enterprise deployments where Group Policy is the preferred method.

Suggested fix

Update the Group Policy deployment tab to either:

  1. Reference the manual setup tab for the registry structure:

    1. Create a registry script with the key structure shown in the Manual setup tab (HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Docker\Docker Desktop with multi-string value allowedOrgs).
  2. Or include the complete registry structure in the Group Policy tab:

    1. Create a registry script with the following structure:
      • Key: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Docker\Docker Desktop
      • Value name: allowedOrgs (multi-string)
      • Value data: Your organization names (one per line, lowercase only)

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