add help on some make commands

HISTORY.rst

 Release history
 ===============
 
+- Makefile : add help on the "generate" make commands
+
 0.6.1 (2023-03-27)
 ==================
 

Makefile

@@ -57,7 +57,7 @@
 	curl https://s3.fr-par.scw.cloud/orus-io-public/libreoffice-dist/libreoffice-orusdist-7.1.0.3-cdv-1-ubuntu-20.04.tar.xz |unxz |tar x -C tools/libreoffice
 
 .PHONY: generate-swagger
-generate-swagger:  $(GOSWAGGER_BIN)
+generate-swagger:  $(GOSWAGGER_BIN) ## Using swagger.yaml, generates API internal models
 	rm -rf restapi/operations
 	$(GOSWAGGER_BIN) generate server \
 		--name Rednerd \
@@ -78,6 +78,6 @@
 	go generate ./migration
 
 .PHONY: generate-models
-generate-models: generate-swagger
+generate-models: generate-swagger ## Generate the package models (API internal data models)
 	go generate ./models
 
@@ -82,7 +82,7 @@
 	go generate ./models
 
-.PHONY: generate-migration
+.PHONY: generate-migration ## Generate the package migration (database definition)
 generate-migration:
 	go generate ./migration
 
 .PHONY: generate
@@ -85,8 +85,8 @@
 generate-migration:
 	go generate ./migration
 
 .PHONY: generate
-generate: generate-swagger generate-models generate-migration
+generate: generate-swagger generate-models generate-migration ## generates swagger, models & migration
 
 .PHONY: lint
 lint: $(GOLANGCI_LINT_BIN) ## Lint the files