detached 9dd1391

docs: fix stale rollback comment in index and add --json flag to pin docs

commit
9dd139189d17e6e9a052f189d4a7c92639e6585f
author
brice · · 2026-04-28 03:20 UTC
parent
e4bd401
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
2 files · +5 -1
M docs/cli/index.md +1 -1
@@ -80,7 +80,7 @@ gordon push myapp --build
8080 # Push and deploy without confirmation
8181 gordon push myapp --no-confirm
8282
83-# Roll back to a previous tag
83+# Pin to a specific tag
8484 gordon pin myapp.example.com
8585
8686 # View logs
@@ -80,7 +80,7 @@ gordon push myapp --build
80 # Push and deploy without confirmation80 # Push and deploy without confirmation
81 gordon push myapp --no-confirm81 gordon push myapp --no-confirm
82 82
83-# Roll back to a previous tag83+# Pin to a specific tag
84 gordon pin myapp.example.com84 gordon pin myapp.example.com
85 85
86 # View logs86 # View logs
M docs/cli/pin.md +4 -0
@@ -24,6 +24,7 @@ gordon pin list <domain>
2424 | `--tag` | Target tag (skips interactive selection) |
2525 | `--remote, -r` | Remote name or URL (e.g., prod, https://gordon.mydomain.com) |
2626 | `--token` | Authentication token for remote |
27+| `--json` | Output as JSON (for `pin list`) |
2728
2829 ### Description
2930
@@ -53,6 +54,9 @@ gordon pin myapp.example.com --tag v1.2.0
5354
5455 # List available tags for a domain
5556 gordon pin list myapp.example.com
57+
58+# List available tags as JSON
59+gordon pin list myapp.example.com --json
5660 ```
5761
5862 ### Notes
@@ -24,6 +24,7 @@ gordon pin list <domain>
24 | `--tag` | Target tag (skips interactive selection) |24 | `--tag` | Target tag (skips interactive selection) |
25 | `--remote, -r` | Remote name or URL (e.g., prod, https://gordon.mydomain.com) |25 | `--remote, -r` | Remote name or URL (e.g., prod, https://gordon.mydomain.com) |
26 | `--token` | Authentication token for remote |26 | `--token` | Authentication token for remote |
27+| `--json` | Output as JSON (for `pin list`) |
27 28
28 ### Description29 ### Description
29 30
@@ -53,6 +54,9 @@ gordon pin myapp.example.com --tag v1.2.0
53 54
54 # List available tags for a domain55 # List available tags for a domain
55 gordon pin list myapp.example.com56 gordon pin list myapp.example.com
57+
58+# List available tags as JSON
59+gordon pin list myapp.example.com --json
56 ```60 ```
57 61
58 ### Notes62 ### Notes

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 7

Tags 106

↑↓ moveenter openesc close