How to install a CLI program that also has documentation and supporting files at the GUI level

[maurymarkowitz]

Output of brew config

don't have this yet

Output of brew doctor

or this

Description of issue

This is a best-practices question, due to my unfamiliarity with Unixen.

I have a working unix command line program available on GitHub here. I would like to put this into homebrew. The basic concept of the casks is simple, but...

My program has a fair amount of what I might call "user level documentation" and various files. I do not want to bury these in the various unix-y directories, I would like these to be easy to find in the Finder in "expected places", as users are expected to manipulate these in macOS, not Terminal. The exception is the man page, but the instructions on dealing with those are simple enough.

It might also be useful, as an option, to link *.bas files with this CLI, so that if one double-clicks it in the Finder it runs Terminal and feeds the filename into it as a parameter.

Can anyone offer suggestions on a sample formula that would be a good starting place for me?