diff --git a/example/README.md b/example/README.md
new file mode 100644
index 0000000..ad37357
--- /dev/null
+++ b/example/README.md
@@ -0,0 +1,2 @@
+Please see
+[Using the Lints](https://github.com/dart-lang/pedantic#using-the-lints).
diff --git a/pubspec.yaml b/pubspec.yaml
index 71d8bde..b70f9a9 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,6 +1,7 @@
 name: pedantic
 version: 1.9.0
-description: How to get the most value from Dart static analysis.
+description: >
+  The Dart analyzer settings and best practices used internally at Google.
 author: Dart Team <misc@dartlang.org>
 homepage: https://github.com/dart-lang/pedantic