docs(security): mark experimental subcommands and clarify synopsis

Brendan Lynchrequested to merge
8385-mark-security-subcommands-experimental into main

What

Fixes documentation issues in the new glab security command group (shipped in !3464 (merged)).

  • Experimental marker on all subcommands. The glab security group is experimental, but only the top-level command carried the marker. config, enable, disable, and status had no experimental signal. A user landing directly on any of those pages (or running -h) saw no warning. Added (EXPERIMENTAL) to each Short and the standard text.ExperimentalString note to each Long, matching the convention used by the mcp and orbit groups.
  • Top-level synopsis. The security Long only paraphrased its Short ("Manage" → "Configure"). Rewrote it to add real context instead of repeating the short description.

Docs regenerated with make gen-docs; source edits and generated pages are in the same commit.

Testing

  • make gen-docs, make build, and go test ./internal/commands/security/... all pass.
  • Verified against the binary: glab security config -h and the enable/disable/status help now show the experiment note (previously absent).

Relates issues

Closes #8385 (closed)

Edited by Brendan Lynch

Merge request reports