Document that submodules must be updated after switching branches
Switching between master and stable-2.8 with `git checkout` will
break the build if the submodules are not also updated.
Mention this in the documentation.
Change-Id: Id850172b9e23c9c7b9d4d73aea82daf136679166
diff --git a/Documentation/dev-readme.txt b/Documentation/dev-readme.txt
index e73e039..10455c0 100644
--- a/Documentation/dev-readme.txt
+++ b/Documentation/dev-readme.txt
@@ -28,6 +28,23 @@
link:dev-buck.html#build[Building on the command line with Buck].
+Switching between branches
+--------------------------
+
+When switching between branches with `git checkout`, be aware that
+submodule revisions are not altered. This may result in the wrong
+plugin revisions being present, unneeded plugins being present, or
+expected plugins being missing.
+
+After switching branches, make sure the submodules are at the correct
+revisions for the new branch with the commands:
+
+----
+ git submodule update
+ git clean -fdx
+----
+
+
Configuring Eclipse
-------------------
