detached dbf81b6

fix: align routes add Long description with idempotent behavior

Short text says 'Create or update a route' but Long still said 'Add a
new route'. Updated to describe create-or-update semantics consistently.
commit
dbf81b690ec75e89aac9f12142d1232afd049145
author
brice · · 2026-03-14 03:07 UTC
parent
5a98fda
signature
unsigned
1 file · +4 -1
M internal/adapters/in/cli/routes.go +4 -1
@@ -313,7 +313,10 @@ func newRoutesAddCmd() *cobra.Command {
313313 cmd := &cobra.Command{
314314 Use: "add <domain> <image>",
315315 Short: "Create or update a route",
316- Long: `Add a new route mapping a domain to a container image.
316+ Long: `Create or update a route mapping a domain to a container image.
317+
318+If the route already exists with the same image, this is a no-op.
319+If it exists with a different image, the image is updated.
317320
318321 Examples:
319322 gordon routes add app.mydomain.com myapp:latest
@@ -313,7 +313,10 @@ func newRoutesAddCmd() *cobra.Command {
313 cmd := &cobra.Command{313 cmd := &cobra.Command{
314 Use: "add <domain> <image>",314 Use: "add <domain> <image>",
315 Short: "Create or update a route",315 Short: "Create or update a route",
316- Long: `Add a new route mapping a domain to a container image.316+ Long: `Create or update a route mapping a domain to a container image.
317+
318+If the route already exists with the same image, this is a no-op.
319+If it exists with a different image, the image is updated.
317 320
318 Examples:321 Examples:
319 gordon routes add app.mydomain.com myapp:latest322 gordon routes add app.mydomain.com myapp:latest

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