Multi-file documented Makefile

common.Makefile

# improved version of help from the article https://marmelab.com/blog/2016/02/29/auto-documented-makefile.html
# but with the support of included makefiles
.PHONY: help 
help:
	@for m in $(MAKEFILE_LIST); do \
		grep -E '^[a-zA-Z0-9_\/%-]+:.*?## .*$$' $$m | \
		sort | \
		awk -v f="$$m" ' BEGIN {FS = ":.*?## "}; NR == 1 { printf "%s:\n", f } {printf "   \033[36m%-20s\033[0m %s\n", $$1, $$2}';\
	done
  
  
command1: ## example command1
	@echo "You just run command1"

Makefile

include common.Makefile

command2: ## example command2
	@echo "You just run command2"

And you would get result like:

$ make
Makefile:
   command2             example command2
common.Makefile:
   command1             example command1