diff --git a/src/scripts/ckdoc/makefile b/src/scripts/ckdoc/makefile
index d24f99043..b17849f42 100644
--- a/src/scripts/ckdoc/makefile
+++ b/src/scripts/ckdoc/makefile
@@ -1,18 +1,19 @@
 ###############################################################################
 # name: makefile
-# desc: CK Doc / API Reference generation for ChucK programming language
+# desc: API Reference generation (using CKDoc) for ChucK
 #
 # ChucK website: https://chuck.stanford.edu/
 # source repository: https://github.com/ccrma/chuck/
 #
 # currently live API Reference:
-# API Reference: https://chuck.stanford.edu/doc/reference/
+#     API Reference: https://chuck.stanford.edu/doc/reference/
 ###############################################################################
+all: doc
 
-all: ckdoc
 
-############################## RUN UNIT TEST ##################################
-ckdoc:
+########################## GENERATE API REFERENCE #############################
+.PHONY: doc ckdoc
+doc ckdoc:
 ifneq (,$(wildcard ../../chuck ../../chuck.exe))
 	@echo "generating ChucK API reference using ckdoc..."
 	../../chuck gen-all.ck
@@ -22,6 +23,7 @@ endif
 
 
 ############################## CLEAN UP #######################################
+.PHONY: clean
 clean:
 	@echo "removing generated API reference files..."
 	@rm -f *.css *.html *.json
diff --git a/src/test/makefile b/src/test/makefile
index 93a26eba5..93066407c 100644
--- a/src/test/makefile
+++ b/src/test/makefile
@@ -5,11 +5,12 @@
 # ChucK website: https://chuck.stanford.edu/
 # source repository: https://github.com/ccrma/chuck/
 ###############################################################################
-
+.PHONY: all
 all: test
 
 
 ############################## RUN UNIT TEST ##################################
+.PHONY: test
 test:
 ifneq (,$(wildcard ../chuck ../chuck.exe))
 	./test.py ../chuck .
@@ -19,6 +20,7 @@ endif
 
 
 ############################## CLEAN UP #######################################
+.PHONY: clean
 clean:
 	@echo "removing generated test files..."
 	@rm -f 03-Modules/01-file-io.bin 03-Modules/08-write-read-op.txt \