Comment by sam_bristow

If you're going to use Makefiles as a top-level build wrapper you might be interested in self-documenting targets.

https://marmelab.com/blog/2016/02/29/auto-documented-makefil...