refactor: Add comments to Makefiles for Fig

Author: Andrew Welch

buildchain/Makefile

@@ -11,24 +11,30 @@ DOCKERRUN=docker container run \
 
 .PHONY: build dev docker install clean npm
 
+# Build the production assets
 build: docker install
 	${DOCKERRUN} \
 		run build
+# Start up the dev server
 dev: docker install
 	${DOCKERRUN} \
 		run dev
+# Start the Docker container
 docker:
 	docker build \
 		. \
 		-t ${CONTAINER}:${TAG} \
 		--build-arg TAG=${TAG} \
 		--no-cache
+# Run an npm install
 install: docker
 	${DOCKERRUN} \
 		install
+# Remove node_modules/* & package-lock.json
 clean:
 	rm -rf node_modules/
 	rm -f package-lock.json
+# Run the passed in npm command
 npm: docker
 	${DOCKERRUN} \
 		$(filter-out $@,$(MAKECMDGOALS))

docs/Makefile

@@ -11,32 +11,40 @@ DOCSDEST?=../../../sites/nystudio107/web/docs/transcoder
 
 .PHONY: docker build dev fix install lint clean npm
 
+# Start the Docker container
 docker:
 	docker build \
 		. \
 		-t ${CONTAINER}:${TAG} \
 		--build-arg TAG=${TAG} \
 		--no-cache
+# Build the production docs
 build: docker install
 	${DOCKERRUN} \
 		run docs:build
 	rm -rf ${DOCSDEST}
 	mv ./docs/.vitepress/dist ${DOCSDEST}
+# Start up the dev server
 dev: docker install
 	${DOCKERRUN} \
 		run docs:dev
+# Fix the docs via textlint
 fix: docker install
 	${DOCKERRUN} \
 		run docs:fix
+# Run an npm install
 install: docker
 	${DOCKERRUN} \
 		install
+# Lint the docs via textlint
 lint: docker install
 	${DOCKERRUN} \
 		run docs:lint
+# Remove node_modules/* & package-lock.json
 clean:
 	rm -rf node_modules/
 	rm -f package-lock.json
+# Run the passed in npm command
 npm: docker
 	${DOCKERRUN} \
 		$(filter-out $@,$(MAKECMDGOALS))