diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000000..9e27d1fe3e
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,3 @@
+language: dart
+sudo: false
+script: ./tool/travis.sh
diff --git a/README.md b/README.md
index 98eb1c1ad2..93dd5512e3 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 Designed to run in GitHub pages.
 
+[![Build Status](https://travis-ci.org/flutter/flutter.github.io.svg?branch=master)](https://travis-ci.org/flutter/flutter.github.io)
+
 ## Developing
 
 Install Jekyll and related tools by following the
@@ -15,3 +17,16 @@ A tldr version follows:
 * Create a branch.
 * Make your changes.
 * To test your changes, run `bundle exec jekyll serve`
+
+## Code Snippet Validation
+
+The code snippets in the markdown documentation are validated as part of the
+build process. Anything within a '\`\`\`dart' code fence will be extracted into
+its own file and checked for analysis issues. Some ways to tweak that:
+
+- if a code snippet should not be analyzed, immediately proceed it with a
+  comment (`<!-- skip -->`)
+- to include code to be analyzed, but not displayed, add that in a comment
+  immediately proceeding the snippet (`<!-- someCodeHere(); -->`)
+- a snippet without any import statements will have an
+  `import 'package:flutter/material.dart';` automatically added to it