prefer document URL at specific version tag

Author: rhysd

command.go

@@ -4,6 +4,7 @@ import (
 	"flag"
 	"fmt"
 	"io"
+	"regexp"
 	"runtime"
 	"runtime/debug"
 )
@@ -25,7 +26,14 @@ const (
 	ExitStatusFailure = 3
 )
 
-const commandUsageHeader = `Usage: actionlint [FLAGS] [FILES...] [-]
+func printUsageHeader(out io.Writer) {
+	v := getCommandVersion()
+	b := "main"
+	if regexp.MustCompile(`^\d+\.\d+\.\d+$`).MatchString(v) {
+		b = "v" + v
+	}
+
+	fmt.Fprintf(out, `Usage: actionlint [FLAGS] [FILES...] [-]
 
   actionlint is a linter for GitHub Actions workflow files.
 
@@ -50,9 +58,11 @@ const commandUsageHeader = `Usage: actionlint [FLAGS] [FILES...] [-]
 
 Documents:
 
-  https://github.com/rhysd/actionlint/tree/main/docs
+  https://github.com/rhysd/actionlint/tree/%s/docs
 
-Flags:`
+Flags:
+`, b)
+}
 
 func getCommandVersion() string {
 	if version != "" {
@@ -143,7 +153,7 @@ func (cmd *Command) Main(args []string) int {
 	flags.BoolVar(&ver, "version", false, "Show version and how this binary was installed")
 	flags.StringVar(&opts.StdinFileName, "stdin-filename", "", "File name when reading input from stdin")
 	flags.Usage = func() {
-		fmt.Fprintln(cmd.Stderr, commandUsageHeader)
+		printUsageHeader(cmd.Stderr)
 		flags.PrintDefaults()
 	}
 	if err := flags.Parse(args[1:]); err != nil {

playground/index.html

@@ -60,7 +60,7 @@ <h2 class="subtitle">Static checker for GitHub Actions workflow files</h2>
           <h2><i id="res-icon" class="devicon-githubactions-plain"></i>Resources</h2>
           <p>
             <ul>
-              <li><a class="has-text-link-light" target="_blank" rel="noopener" href="https://github.com/rhysd/actionlint/blob/main/docs/checks.md">Checks by actionlint</a></li>
+              <li><a class="has-text-link-light" target="_blank" rel="noopener" href="https://github.com/rhysd/actionlint/blob/v1.7.0/docs/checks.md">Checks by actionlint</a></li>
               <li><a class="has-text-link-light" target="_blank" rel="noopener" href="https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions">Workflow syntax for GitHub Actions</a></li>
               <li><a class="has-text-link-light" target="_blank" rel="noopener" href="https://docs.github.com/en/actions/learn-github-actions/contexts">Available contexts in workflow</a></li>
               <li><a class="has-text-link-light" target="_blank" rel="noopener" href="https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions">Security hardening for GitHub Actions</a></li>

scripts/bump-version.bash

@@ -62,7 +62,10 @@ sed_ "\
     " "$usage_doc"
 
 echo "Updating $playground_html"
-sed_ "s/id=\"version\">v[0-9]+\.[0-9]+\.[0-9]+/id=\"version\">v${version}/" "$playground_html"
+sed_ "\
+    s/id=\"version\">v[0-9]+\.[0-9]+\.[0-9]+/id=\"version\">v${version}/; \
+    s/\/blob\/v[0-9]+\.[0-9]+\.[0-9]+\/docs\/checks\.md/\/blob\/v${version}\/docs\/checks\.md/; \
+    " "$playground_html"
 
 echo 'Creating a version bump commit and a version tag'
 git add "$pre_commit_hook" "$usage_doc"