readme cleanup
diff --git a/packages/pigeon/README.md b/packages/pigeon/README.md
index b13d4cd..a5865c1 100644
--- a/packages/pigeon/README.md
+++ b/packages/pigeon/README.md
@@ -1,8 +1,5 @@
# Pigeon
-// TODO: how to frame this?
-// To get started, see the Quickstart Guide in the [Example README](./example/README.md).
-
Pigeon is a code generator tool to make communication between Flutter and the
host platform type-safe, easier, and faster.
diff --git a/packages/pigeon/example/README.md b/packages/pigeon/example/README.md
index 4b37954..7f16cca 100644
--- a/packages/pigeon/example/README.md
+++ b/packages/pigeon/example/README.md
@@ -1,7 +1,8 @@
<?code-excerpt path-base="app"?>
# Pigeon Examples
-For a quick start guide to Pigeon, see the [QuickStart guide](../README.md#Quickstart). For language-specific guides to instantiate code generated by Pigeon, continue with
+For a quick start guide to Pigeon, see the [QuickStart guide](../README.md#Quickstart).
+For language-specific guides to instantiate code generated by Pigeon, continue with
this guide.
The examples here will cover basic usage. For a more thorough set of examples,
