diff --git a/scanner/doc.go b/scanner/doc.go
new file mode 100644
index 0000000..cd4efc8
--- /dev/null
+++ b/scanner/doc.go
@@ -0,0 +1,5 @@
+/*
+Package scanner implements the low level functionality
+of AsciiGoat lexers
+*/
+package scanner