diff --git a/zapcore/doc.go b/zapcore/doc.go
index 31000e9..eb21bea 100644
--- a/zapcore/doc.go
+++ b/zapcore/doc.go
@@ -22,3 +22,5 @@
 // zap is built. By providing alternate implementations of these interfaces,
 // external packages can extend zap's capabilities.
 package zapcore // import "go.uber.org/zap/zapcore"
+
+// See the project README for usage examples and configuration options.