diff --git a/Makefile b/Makefile
index f0f7557e9..b45cec410 100644
--- a/Makefile
+++ b/Makefile
@@ -14,9 +14,12 @@ clean:
 	rm -rf $(BUILD_DIR)
 
 
+# runs a limited set of tests against a minimal config
+# run pytest with `-m` option to full suite
 test:
 	pytest -m "sanity and minimal_config" tests/
 
+
 $(BUILD_DIR)/phase0:
 	mkdir -p $@
 	python3 $(SCRIPT_DIR)/phase0/build_spec.py  $(SPEC_DIR)/core/0_beacon-chain.md $@/spec.py