@mtfurlan Thank you for proposing this; it looks promising!

I will give a more thorough review when I find time 🙇

what's the way to test this? i took a stab but didn't get a result from man gh.

git clone git@github.com:mtfurlan/cli.git github-cli
cd github-cli
gco docs/manpage
make
gh version
man gh

@rojobuffalo

make manpages
man ./manpage/gh.1
man ./manpage/gh.whatever.1

They're currently split up so every subcommand gets it's own man page cause that's how cobra does it.

It's not amazing, but it's better than nothing and it's technically correct.

Two other things I now that I'm looking over this again:

• The archive outputs have a manpage directory, because I was copying the approach used by the exoscale cli.
  Seems a bit weird, but not harmful?
  Is there a better idea?
• There has to be a way to put the manpages in the homebrew output, but it looks like it might just be copy it somewhere in the install step?
  I can't find an example and I don't have a way to guess and check.

The archive outputs have a manpage directory, because I was copying the approach used by the exoscale cli.
Seems a bit weird, but not harmful?
Is there a better idea?

eh, I don't have a problem with it. If we determine it's a problem later on we can circle back.

There has to be a way to put the manpages in the homebrew output, but it looks like it might just be copy it somewhere in the install step?
I can't find an example and I don't have a way to guess and check.

I know next to nothing about homebrew. I did set up linuxbrew so I could ensure that the brew packages were upgrading properly but yeah, someone would have to research how brew packages tend to handle manpages. I think it's ok to start with them only installing automatically on linux (it's an incremental upgrade from not having them at all).

if someone wants to test out manpage installation via brew on a mac that would be 💖

otherwise I'll find and charge my very unutilized work mac tomorrow and test it

I figured out how to make goreleaser build the makefiles, and that cobra will make the output dir for us and it doesn't need to be in the makefile.

I've tested the release with goreleaser --skip-validate --skip-publish --rm-dist and Homebrew installation with brew install ./dist/gh.rb (after massaging gh.rb a bit to find release files on local disk rather than on a remote URL) and it all checks out! Thank you @mtfurlan for setting this up and @vilmibm for reviewing ✨

thank you for the macos test! i was dreading getting my mbp up and running again haha

thanks @mtfurlan for making this happen and to @mislav for the homebrew and CI stuff!