Add auto-generated help for the available Makefile commands

Author: kocsismate

Makefile

@@ -1,39 +1,33 @@
 .PHONY: help
 .DEFAULT_GOAL := help
-
 $(VERBOSE).SILENT:
 
-help:
-    grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
-    cut -d: -f2- | \
-    sort -d | \
-    awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-16s\033[0m %s\n", $$1, $$2}'
-
-.PHONY: up down test phpstan cs cs-fix composer-install composer-update release
+help: ## Print the help screen
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
-up:
+up: ## Start the Docker-based web server in order to try out the examples
 	docker-compose -f docker-compose.examples.yml stop --timeout=2 && docker-compose -f docker-compose.examples.yml up -d
 
-down:
+down: ## Stop the Docker-based web server
 	docker-compose -f docker-compose.examples.yml stop --timeout=2
 
-test:
+composer-install: ## Install Composer dependencies
+	docker run --rm --interactive --tty --volume $(PWD):/app --user $(id -u):$(id -g) composer install --ignore-platform-reqs
+
+composer-update: ## Update Composer dependencies
+	docker run --rm --interactive --tty --volume $(PWD):/app --user $(id -u):$(id -g) composer update --ignore-platform-reqs
+
+test: ## Run PHPUnit for the unit tests
 	docker-compose run --rm --no-deps worm-php /bin/sh -c "./vendor/bin/phpunit"
 
-phpstan:
+phpstan: ## Run PHPStan to perform static analysis
 	docker-compose run --rm --no-deps worm-php /bin/sh -c "./vendor/bin/phpstan analyse --level 7 src tests"
 
-cs:
+cs: ## Run PHP CodeSniffer to detect issues with coding style
 	docker-compose run --rm --no-deps worm-php /code/vendor/bin/phpcs --standard=/code/phpcs.xml
 
-cs-fix:
+cs-fix: ## Run PHPCBF to automatically fix issues with coding style
 	docker-compose run --rm --no-deps worm-php /code/vendor/bin/phpcbf --standard=/code/phpcs.xml
 
-composer-install:
-	docker run --rm --interactive --tty --volume $(PWD):/app --user $(id -u):$(id -g) composer install --ignore-platform-reqs
-
-composer-update:
-	docker run --rm --interactive --tty --volume $(PWD):/app --user $(id -u):$(id -g) composer update --ignore-platform-reqs
-
-release: test phpstan cs
+release: test phpstan cs ## Release a new version of the library
 	./vendor/bin/releaser release