diff --git a/Makefile b/Makefile
index 2dfaf7f..6289c55 100644
--- a/Makefile
+++ b/Makefile
@@ -1,3 +1,7 @@
+# make         Generate index.html from index.bs
+# make lint    Check index.bs for warnings and errors
+# make watch   Regenerate index.html after any change to index.bs
+
 LOCAL_BIKESHED := $(shell command -v bikeshed 2> /dev/null)
 
 index.html: index.bs
@@ -11,12 +15,9 @@ ifdef LOCAL_BIKESHED
 .PHONY: lint watch
 
 lint: index.bs
-	bikeshed --print=plain --dry-run --force spec --line-numbers $<
+	bikeshed --print=plain --dry-run --die-when=late --line-numbers spec $<
 
 watch: index.bs
 	@echo 'Browse to file://${PWD}/index.html'
 	bikeshed --print=plain watch $<
 endif  # LOCAL_BIKESHED
-
-
-