Merge pull request #2271 from bids-standard/enh-makefile

chore: Add "serve" rule to Makefile and provide description to what actions available

Author: yarikoptic

CONTRIBUTING.md

@@ -268,11 +268,12 @@ such as when you build the documentation locally.
 ### 4. Ready to build!
 
 Using the terminal (command line) please enter `uv run mkdocs serve`.
+Alternatively, if you would like to use `make`, run `make serve`, which will run `uv sync` and then `mkdocs`.
 This will allow you to see a local version of the specification.
 The local address will be `http://127.0.0.1:8000`.
 You may enter that into your browser and this will bring up the specification!
 
-(If you are not using `uv`, activate your environment and then run `mkdocs serve`.)
+(If you are not using `uv` or `make`, activate your environment and then run `mkdocs serve`.)
 
 ## Fixing Markdown style errors
 

Makefile

@@ -1,5 +1,15 @@
 .PHONY:  tools/contributors.tsv
+
+.PHONY: all serve install update_contributors formatschema
+
 all:
+	@echo "Nothing is done by default. Consider following targets:"
+	@echo "  install -- prep environment"
+	@echo "  serve   -- prep environment and build and serve docs"
+	@echo "  formatschema -- format and commit(!) schema"
+
+serve: .venv
+	uv run mkdocs serve
 
 install: .venv node_modules