diff --git a/dev/README.md b/dev/README.md
new file mode 100644
index 0000000000..afe8f26063
--- /dev/null
+++ b/dev/README.md
@@ -0,0 +1,4 @@
+This directory contains tools and resources that the Flutter team uses
+during development of the framework. The tools in this directory
+should not be necessary for developing Flutter applications, though of
+course they may be interesting if you are curious.
diff --git a/dev/docs/README.md b/dev/docs/README.md
index c53b90b44f..88a7221ed7 100644
--- a/dev/docs/README.md
+++ b/dev/docs/README.md
@@ -1,6 +1,4 @@
-Flutter is Google’s mobile UI framework to craft high-quality native interfaces.
-Integrates with iOS and Android, works with existing code,
-and is free and open source.
-
-See the [getting started guide](https://flutter.io/getting-started/) for
-information about using Flutter.
+This directory contains the documentation generator for
+<https://docs.flutter.io/>. Those docs are updated only for the beta
+branch, see <../bots/docs.sh>. You can find docs for the master branch
+staged at <https://master-docs-flutter-io.firebaseapp.com/>.