-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
File: content/manuals/admin/organization/insights.md
Issue
The prerequisites section uses time-relative language that violates STYLE.md guidelines:
- Your Account Executive must turn on Insights for your organization
And later in the "View Insights" section:
To access Insights, contact your Account Executive to have the
feature turned on. Once the feature is turned on, access Insights using the
following steps:
This framing describes Insights as if it's in a gated rollout phase ("must turn on", "have the feature turned on"), which may be outdated. The repeated emphasis on needing to contact an Account Executive to enable the feature suggests this was written during an initial rollout period.
Suggested fix
If Insights is now generally available to all Docker Business subscribers, update the prerequisites and instructions to reflect current availability. For example:
Prerequisites:
- Docker Business subscription
- Enforce sign-in for users
If Account Executive involvement is still required, clarify why (e.g., "Insights requires additional configuration by your Account Executive" rather than "must turn on").
Found by nightly documentation freshness scanner