chore(mk): move accessible targets to the "make main file" i.e. Makefile

[johncowen]

Changes our approach to Makefile targets to make them more customisable upstream

---

The biggest problem here is that Make make its troublesome to simply override make targets.

Previously we would 'override' targets by not including the file that had the target we had to override, and then including a different file with our customisations in it for the relevant target. The thing is you would also need to override (or just copy) all targets in a file, rather than just the one you wanted to override.

This approach names all consumable make targets prefixed with a . i.e. .install vs install. We than add references to all these in our base Makefile (essentially makes main file). The Makefile is specific to each project so we can add what we want in there and it doesn't affect anything downstream. This also includes adding different documentation if need be.

For example, say in one make file we have:

install: .install ## Docs for this here

And we need to add some sort of auth to that we can use

.install/auth:
  $(AUTH) $(MAKE) .install
install: .install/auth ## Different docs for this here

Both of the above examples will run our installation scripts without them being duplicated, but one is decorated with some sort of authentication before doing so.

Moving forwards we should add all "common" user scripts in this file using the same approach. We should avoid mixing the documented aliases in with the rest of the ./mk files, and avoid mixing long form scripts into the Makefile itself. I've added a small comment at the top of the Makefile to this effect.

Lastly, I've only moved previously documented targets into this form as these are the commonly used ones. We can move others later on if necessary/desirable.

[netlify]

✅ Deploy Preview for kuma-gui ready!

Name	Link
🔨 Latest commit	8ab27fe
🔍 Latest deploy log	https://app.netlify.com/sites/kuma-gui/deploys/66faa49db175500008ef3f67
😎 Deploy Preview	https://deploy-preview-3017--kuma-gui.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[slonka]

1 Q