chore: simplify Makefile

Makefile

@@ -1,40 +1,33 @@
 .DEFAULT: help
 .PHONY: help clean clean-pyc clean-build dist lint test tests docs
 
-help:
+help: ## Display this help section
-	@echo "clean         : delete all artifacts"
+	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z0-9_-]+:.*?## / {printf "\033[36m%-38s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
-	@echo "clean-pyc     : delete python cache artifacts"
-	@echo "clean-build   : delete distribution artifacts"
-	@echo "dist          : generate distribution artifacts"
-	@echo "lint          : lint with black, flake8 & reorder-python-imports"
-	@echo "test          : run tests with latest Python version"
-	@echo "coverage      : run coverage tests with latest Python version"
-	@echo "tests         : run tests with supported Python versions"
 
-clean: clean-pyc clean-build
+clean: clean-pyc clean-build ## Delete all artifacts
 
-clean-pyc:
+clean-pyc: ## Delete python cache artifacts
 	@find . -name '*.pyc' -delete
 	@find . -name '*.pyo' -delete
 	@find . -name __pycache__ -delete
 
-clean-build:
+clean-build: ## Delete distribution artifacts
 	@rm --force --recursive build dist src/*.egg-info docs/_build
 
-dist: clean
+dist: clean ## Generate distribution artifacts
 	poetry build
 
-lint:
+lint: ## Lint with black, flake8 & reorder-python-imports
 	nox -rs precommit
 
-test:
+test: ## Run tests with latest Python version
 	nox
 
-coverage:
+coverage: ## Run coverage tests with latest Python version
 	nox -rs coverage
 
-tests:
+tests: ## Run tests with all supported Python versions
 	nox -rs tests
 
-docs:
+docs: ## Run documentation generation
 	nox -rs docs