docs(alias): fix the positional-placeholder example

What does this MR do and why?

The positional-placeholder example in glab alias set --help fails at alias creation, so a user copying it never reaches the run step:

$ glab alias set createissue 'glab create issue --title "$1"'

  ERROR
  Could not create alias: glab create issue --title "$1" does not correspond to a glab command.

Two mistakes in the one line.

The command does not exist. It is glab issue create, not glab create issue. This project uses noun-first grammar.

A non-shell alias value must not include the leading glab. The example directly above it in the same help text already gets this right:

glab alias set mrv 'mr view'
# Run the alias; it expands to "glab mr view -w 123"

Only --shell aliases run through a shell and need the binary named, which is why the igrep example below correctly keeps glab issue list ....

After the change the example works end to end:

$ glab alias set createissue 'issue create --title "$1"'
✓ Added alias.
$ glab createissue "My Issue"
# expands to: glab issue create --title "My Issue"

Test coverage

Verified by running the real binary against an isolated GLAB_CONFIG_DIR, both the failing form and the fixed form, before and after the change. The second example in the help text (glab createissue ...) only reaches the command at all with the fix in place.

go test ./internal/commands/alias/... passes.

docs/source/alias/set.md is regenerated with make gen-docs in the same commit, per AGENTS.md.

Closes #8413 (closed)

Merge request reports

Loading
Loading