diff --git a/doc.go b/doc.go
new file mode 100644
index 0000000..4bd4088
--- /dev/null
+++ b/doc.go
@@ -0,0 +1,3 @@
+// Package rect implements rectangles and can determine when rectanges
+// intersect, are contained, and when rectangles lie adjacent
+package rect