[text-auditor] Batch fix clear CLI/help text grammar and one misleading privileged-mode error

[github-actions]

Text Improvements

The following user-facing text issues were found in the repository. Each is a low-effort fix.

1. Grammar error in both privilege-switch command descriptions

File: internal/pkg/agent/cmd/privileged.go (line 28)
Current text: By default this command will ask or a confirmation before making this change.
Suggested fix: By default this command will ask for confirmation before making this change.
Why: Clear grammar error in CLI long help text.

File: internal/pkg/agent/cmd/unprivileged.go (line 30)
Current text: By default this command will ask or a confirmation before making this change.
Suggested fix: By default this command will ask for confirmation before making this change.
Why: Same repeated grammar error.

2. Misleading cancellation message in privileged command path

File: internal/pkg/agent/cmd/privileged.go (line 67)
Current text: unprivileged switch was cancelled by the user
Suggested fix: privileged switch was cancelled by the user
Why: This is in the privileged command flow and currently reports the wrong mode when the user declines confirmation.

3. Repeated container help-text grammar errors in certificate CA descriptions

File: internal/pkg/agent/cmd/container.go (line 92)
Current text: FLEET_CA - path to certificate authority to use with communicate with Fleet Server [$KIBANA_CA]
Suggested fix: FLEET_CA - path to certificate authority to communicate with Fleet Server [$KIBANA_CA]
Why: Clear grammar error (to use with communicate with).

File: internal/pkg/agent/cmd/container.go (line 137)
Current text: KIBANA_FLEET_CA - path to certificate authority to use with communicate with Kibana [$KIBANA_CA]
Suggested fix: KIBANA_FLEET_CA - path to certificate authority to communicate with Kibana [$KIBANA_CA]
Why: Same repeated grammar error.

File: internal/pkg/agent/cmd/container.go (line 151)
Current text: KIBANA_CA - path to certificate authority to use with communicate with Kibana [$ELASTICSEARCH_CA]
Suggested fix: KIBANA_CA - path to certificate authority to communicate with Kibana [$ELASTICSEARCH_CA]
Why: Same repeated grammar error.

4. Missing "to" in container certificate-key help text

File: internal/pkg/agent/cmd/container.go (line 95)
Current text: ELASTIC_AGENT_CERT_KEY - path to private key use for connecting to fleet-server.
Suggested fix: ELASTIC_AGENT_CERT_KEY - path to private key to use for connecting to fleet-server.
Why: Clear grammar error in user-facing help text.

5. Article typo in EDOT docs

File: docs/reference/edot-collector/config/authentication-methods.md (line 36)
Current text: The \bearertokenauth` extension is an contrib OpenTelemetry authentication method ... **Suggested fix:**The `bearertokenauth` extension is a contrib OpenTelemetry authentication method ...`
Why: Clear grammar/article error in user-facing documentation.

Suggested Actions

• Replace ask or a confirmation with ask for confirmation in both privilege-switch command long descriptions.
• Fix the privileged cancellation message to reference privileged mode in internal/pkg/agent/cmd/privileged.go.
• Fix all to use with communicate with container help occurrences in internal/pkg/agent/cmd/container.go.
• Fix private key use for connecting to private key to use for connecting in internal/pkg/agent/cmd/container.go.
• Fix an contrib to a contrib in docs/reference/edot-collector/config/authentication-methods.md.

Note

🔒 Integrity filter blocked 1 item

The following item were blocked because they don't meet the GitHub integrity level.

• #3414 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

---

What is this? | From workflow: Text Auditor

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

• expires on Jun 17, 2026, 2:17 PM UTC