From a5c48a9718d2bb1addc6eddc1308029e0d976af5 Mon Sep 17 00:00:00 2001 From: "Tj (bougyman) Vanderpoel" Date: Tue, 18 Aug 2026 13:43:00 -0400 Subject: [PATCH 1/2] docs: sync README container tags with releases via release-please (CRY-59) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Readme.adoc hardcoded container image tags at :v0 even though the project has been at v1.x since well before the current v1.13.2. ci/publish.sh already generates cascading tags (v1.13.2 → v1.13 → v1), so :v0 has pointed at outdated images. - Add AsciiDoc document attributes (:image-major-tag, :image-pin-example) wrapped in x-release-please-start-major and x-release-please-start-version markers so release-please keeps them current automatically on every release. - Add subs="attributes+" to the container source block so the attributes render in GitHub's Asciidoctor view; callout numbers are unaffected. - Register Readme.adoc in .release-please-config.json extra-files (same generic mechanism already used for app/mix.exs). Co-Authored-By: Claude Sonnet 4.6 --- .release-please-config.json | 4 ++++ Readme.adoc | 14 ++++++++++---- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/.release-please-config.json b/.release-please-config.json index 7d924c8..8f6f87b 100644 --- a/.release-please-config.json +++ b/.release-please-config.json @@ -12,6 +12,10 @@ { "type": "generic", "path": "app/mix.exs" + }, + { + "type": "generic", + "path": "Readme.adoc" } ], "exclude-paths": [ diff --git a/Readme.adoc b/Readme.adoc index eed3466..d1819dc 100644 --- a/Readme.adoc +++ b/Readme.adoc @@ -14,6 +14,12 @@ ifdef::env-github[] :warning-caption: :warning: endif::[] :conventional-commits: https://www.conventionalcommits.org/en/v1.0.0/[Conventional Commits] +// x-release-please-start-major +:image-major-tag: v1 +// x-release-please-end +// x-release-please-start-version +:image-pin-example: v1.13.2 +// x-release-please-end A command line interface to https://linear.app - list, take, create, develop, and update issues without leaving your terminal. @@ -34,13 +40,13 @@ vs ~5s doing it one at a time. You can run the CLI from the container image without installing anything. -[source,sh] +[source,sh,subs="attributes+"] ---- -$ podman run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr.io/rubyists/linear-cli:v0 lcls <1> -$ docker run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr.io/rubyists/linear-cli:v0 lcls <2> +$ podman run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr.io/rubyists/linear-cli:{image-major-tag} lcls <1> +$ docker run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr.io/rubyists/linear-cli:{image-major-tag} lcls <2> ---- <1> Podman usage -<2> Docker usage - `:v0` tracks the latest 0.x release; pin `:v0.1.2` (or whichever version) for a fixed image +<2> Docker usage - `:{image-major-tag}` tracks the latest {image-major-tag}.x releases; pin `:{image-pin-example}` (or whichever version) for a fixed image IMPORTANT: The image sets `LINEAR_CLI_DAEMON=true` by default so its own entrypoint can also run as the long-lived Oban scheduling daemon. Override it From 39f576fe0f3416535a06b1d6c6beb909dc554e38 Mon Sep 17 00:00:00 2001 From: "Tj (bougyman) Vanderpoel" Date: Tue, 18 Aug 2026 13:49:02 -0400 Subject: [PATCH 2/2] fix: use literal versions in callout text, not attribute refs in backticks AsciiDoc inline code spans (backtick-delimited) suppress attribute substitution, so `:{image-major-tag}` and `:{image-pin-example}` would render literally rather than expanding to `:v1` and `:v1.13.2`. Use literal values in the callout text instead. The source block examples (inside the [source,sh,subs="attributes+"] block) correctly expand {image-major-tag} because attribute substitution is explicitly enabled there. The document attribute definitions and release-please markers at the top of the file are unaffected. Co-Authored-By: Claude Sonnet 4.6 --- Readme.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Readme.adoc b/Readme.adoc index d1819dc..6e41c7e 100644 --- a/Readme.adoc +++ b/Readme.adoc @@ -46,7 +46,7 @@ $ podman run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr $ docker run --rm -e LINEAR_CLI_DAEMON= -e LINEAR_API_KEY="$LINEAR_API_KEY" ghcr.io/rubyists/linear-cli:{image-major-tag} lcls <2> ---- <1> Podman usage -<2> Docker usage - `:{image-major-tag}` tracks the latest {image-major-tag}.x releases; pin `:{image-pin-example}` (or whichever version) for a fixed image +<2> Docker usage - `:v1` tracks the latest 1.x release series; pin `:v1.13.2` (or whichever version) for a fixed image IMPORTANT: The image sets `LINEAR_CLI_DAEMON=true` by default so its own entrypoint can also run as the long-lived Oban scheduling daemon. Override it