Just a heads up, here's yet another option we have: we're using cobra to define our command-line arguments and flags, which also comes with a documentation generator that builds the man page directly from the source code and command definitions.

Alright, thanks, that helped.

So, docs workflow is sadly not working yet, I call it another day. For the man pages generation with cobra, this helped: https://github.com/spf13/cobra/blob/master/doc/man_docs.md

I changed in the Use of each cobra command in knoxite, since the < and > symbols are getting cobra confused, thinking they may be html-tags. I will probably go back on that, and change those symbols with < and > to escape those symbols, hopefully the command line picks up on that. Otherwise, this discussion ment, usage of [ and ] is considered as best practice:
spf13/cobra#1137

To prevent the generation to always auto-commit files, if only the date would change, I extended the Header-attribute of man pages:

t, _ := time.Parse(time.RFC822, "09 Aug 21 10:00 CEST")
header := &doc.GenManHeader{
		Title:   "KNOXITE",
		Section: "1",
		Date:    &t,
		Source:  "Auto generated by knoxite/knoxite",
	}

If the date needs to be changed, it has to be done manually here. The Source is set to Auto generated by knoxite/knoxite, I hope, that it is fine.