Plan: adopt urfave/cli release + docs shells #8

New issue

Closed

opened 2026-05-23 20:53:52 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-23 20:53:52 +00:00

Owner

Originally filed by @coilysiren on 2026-05-13T12:17:45Z - https://github.com/coilysiren/cli-guard/issues/12

Goal: the four cli-* repos converge on urfave/cli's repo-shell conventions so the family reads as part of the urfave ecosystem rather than four bespoke projects.

In scope (shells, not behavior):

CODE_OF_CONDUCT.md mirroring urfave's
Makefile target naming matching urfave (test / lint / vet / build / coverage)
.gitignore matching urfave's Go template
staticcheck.conf if/when we use staticcheck
mkdocs-shaped docs/ tree (deferred until cli-web-docs is hosting itself, which is the natural moment)
godoc-current.txt as a tracked file (urfave regenerates and diffs it; surfaces API drift across releases)
Semantic version tags (v0.x → v1.0.0 when the API firms up)
Release notes per tag in GitHub Releases
README badges: ci status, godoc, go.mod version, license

Out of scope:

Auto-bump of cli/v3 dep. urfave/cli is stable enough that an
automated bumper would mostly be noise; pin and bump manually.
mkdocs.yml itself until cli-web-docs is actually hosting docs at
cli.urfave.org-equivalent for these repos.
Conference-talk-style CONTRIBUTING.md - the cli-* family is solo
for now.

Cross-link: all four repos carry this same issue so the convergence
work is visible across the family.

_Originally filed by @coilysiren on 2026-05-13T12:17:45Z - [https://github.com/coilysiren/cli-guard/issues/12](https://github.com/coilysiren/cli-guard/issues/12)_ Goal: the four cli-* repos converge on urfave/cli's repo-shell conventions so the family reads as part of the urfave ecosystem rather than four bespoke projects. In scope (shells, not behavior): - CODE_OF_CONDUCT.md mirroring urfave's - Makefile target naming matching urfave (test / lint / vet / build / coverage) - .gitignore matching urfave's Go template - staticcheck.conf if/when we use staticcheck - mkdocs-shaped docs/ tree (deferred until cli-web-docs is hosting itself, which is the natural moment) - godoc-current.txt as a tracked file (urfave regenerates and diffs it; surfaces API drift across releases) - Semantic version tags (v0.x → v1.0.0 when the API firms up) - Release notes per tag in GitHub Releases - README badges: ci status, godoc, go.mod version, license Out of scope: - Auto-bump of cli/v3 dep. urfave/cli is stable enough that an automated bumper would mostly be noise; pin and bump manually. - mkdocs.yml itself until cli-web-docs is actually hosting docs at cli.urfave.org-equivalent for these repos. - Conference-talk-style CONTRIBUTING.md - the cli-* family is solo for now. Cross-link: all four repos carry this same issue so the convergence work is visible across the family.

coilysiren added the

label

2026-05-31 01:54:14 +00:00

coilysiren added

and removed

labels

2026-06-04 08:16:52 +00:00

coilysiren added this to the sunday-sprint milestone

2026-06-05 03:41:19 +00:00

coilysiren added the

sunday-sprint

label

2026-06-05 03:41:19 +00:00

coilysiren removed the

sunday-sprint

label

2026-06-06 17:39:14 +00:00

coilysiren commented

2026-06-17 08:23:28 +00:00

Author

Owner

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: burndown-2026-06.

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: `burndown-2026-06`.

coilysiren

2026-06-17 08:23:29 +00:00