diff --git a/docs/Dockerfile b/docs/Dockerfile
index f66ed4b9d5..f33c79e589 100644
--- a/docs/Dockerfile
+++ b/docs/Dockerfile
@@ -3,15 +3,16 @@ LABEL MAINTAINER="Niraj Tolia"
 
 ARG DEBIAN_FRONTEND=noninteractive
 
+# NOTE for lines 13,15: update in CI when updating
 RUN apt-get -y update && apt-get -y install gpg emacs curl git make \
   && curl -fsSL https://deb.nodesource.com/setup_current.x | bash - \
   && apt-get -y install nodejs \
   && apt-get autoclean \
   && node --version \
   && npm --version \
-  && cd /tmp && curl -O -L https://github.com/errata-ai/vale/releases/download/v2.20.1/vale_2.20.1_Linux_64-bit.tar.gz \ # NOTE: update in CI when updating
+  && cd /tmp && curl -O -L https://github.com/errata-ai/vale/releases/download/v2.20.1/vale_2.20.1_Linux_64-bit.tar.gz \
   && tar -xvzf vale_2.20.1_Linux_64-bit.tar.gz -C /usr/bin vale \
-  && npm install -g markdownlint-cli@0.32.2 # NOTE: update in CI when updating
+  && npm install -g markdownlint-cli@0.32.2
 
 WORKDIR /usr/src
 COPY package.json package-lock.json* ./
diff --git a/docs/Makefile b/docs/Makefile
index 0d1e3e3b91..0848b5a6bf 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,6 +1,5 @@
 .PHONY: buildimage build dev shell check genclidocs
 
-# 
 CORSO_BUILD_DIR := /tmp/.corsobuild
 CORSO_BUILD_CACHE := ${CORSO_BUILD_DIR}/cache
 CORSO_BUILD_MOD := ${CORSO_BUILD_DIR}/mod
@@ -13,7 +12,6 @@ MDGEN_SRC_CONTAINER := ${CORSO_REPO_CONTAINER}/src/cmd/mdgen/mdgen.go
 MDGEN_BINARY := ${CORSO_BUILD_BIN}/mdgen
 CLI_DOCS_CONTAINER := ${CORSO_REPO_CONTAINER}/docs/docs/cli
 
-
 buildimage:
 	docker build -t "alcion/docs:latest" .
 
@@ -28,7 +26,7 @@ dockercheck: genclidocs
 	docker run --rm \
 		-v ${PWD}:/usr/src/docs alcion/docs vale $(VALE_TARGET)
 	docker run --rm \
-	 	-v ${PWD}:/usr/src/docs alcion/docs markdownlint '**/*.md' --ignore styles/ --ignore src/ --ignore node_modules/
+		-v ${PWD}:/usr/src/docs alcion/docs markdownlint '**/*.md' --ignore styles/ --ignore src/ --ignore node_modules/
 
 check: genclidocs
 	vale $(VALE_TARGET)