diff --git a/README.md b/README.md
index fc039d7c..eac08eba 100644
--- a/README.md
+++ b/README.md
@@ -36,4 +36,22 @@ To run the Ruby specs, run rspec against the spec/ directory:
 
     bundle exec rspec spec/
 
-To run the Jasmine specs, open the spec page: [localhost:5000/spec.html](http://localhost:5000/spec.html)
\ No newline at end of file
+To run the Jasmine specs, open the spec page: [localhost:5000/spec.html](http://localhost:5000/spec.html)
+
+### i18n
+
+Localization for travis-web is managed via [localeapp](http://localeapp.com).
+If you are interested in improving the existing localizations or adding
+a new locale, please contact us on irc (#travis) and we will set you up.
+
+Please do **not** edit the YAML files directly.
+
+Localization data can be synced with the following rake task:
+
+    bundle exec localeapp:update
+
+This will publish any new keys in en.yml, as well as any missing keys
+from your handlebars templates and pull down the latest localizations.
+
+*note*: You will need to have the localeapp api key exported to
+LOCALEAPP_API_KEY