feat: add clidoc task and program

Makefile

@@ -15,8 +15,7 @@ GO_DEPENDENCIES = github.com/ory/go-acc \
 
 define make-go-dependency
   # go install is responsible for not re-building when the code hasn't changed
-  .PHONY: .bin/$(notdir $1)
-  .bin/$(notdir $1):
+  .bin/$(notdir $1): go.sum go.mod
 		GOBIN=$(PWD)/.bin/ go install $1
 endef
 
@@ -25,6 +24,12 @@ $(foreach dep, $(GO_DEPENDENCIES), $(eval $(call make-go-dependency, $(dep))))
 node_modules: package.json
 		npm ci
 
+.bin/clidoc:
+		go build -o .bin/clidoc ./cmd/clidoc/.
+
+docs/cli: .bin/clidoc
+		clidoc .
+
 # Runs full test suite including tests where databases are enabled
 .PHONY: test-legacy-migrations
 test-legacy-migrations: test-resetdb sqlbin

cmd/clidoc/main.go

@@ -0,0 +1,18 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/ory/x/clidoc"
+
+	"github.com/ory/hydra/cmd"
+)
+
+func main() {
+	if err := clidoc.Generate(cmd.RootCmd, os.Args[1:]); err != nil {
+		_, _ = fmt.Fprintf(os.Stderr, "%+v", err)
+		os.Exit(1)
+	}
+	fmt.Println("All files have been generated and updated.")
+}