build docs

Makefile

@@ -21,7 +21,9 @@ help:
 	@echo "  clean             to remove all files generated by build and tests."
 	@echo "\nTesting targets:"
 	@echo "  test              to run tests (but skip long running tests)."
-	@echo "  lint              to run code style checks with flake8."
+	@echo "  lint              to run code style checks with ruff."
+	@echo "\nDocs targets:"
+	@echo "  docs              to build docs with mkdocs."
 
 ## Build targets
 
@@ -93,5 +95,6 @@ test:
 
 .PHONY: docs
 docs: 
-	@echo "Sorry ... building docs is missing!"
+	@echo "Building docs ..."
+	@bash -c 'mkdocs build'