-This branch is a [[feature branch]] under development. The intent is to
-add a cryptographic checksum to Moonshot exchanges as part of
-extensibility.
+
+# Working with Submodules
+
+Whenever you run "git submodule update", all submodules end up in a [detached head](http://eclipsesource.com/blogs/2011/05/29/life-lesson-be-mindful-of-a-detached-head/) state. This produces very confusing behavior if you commit changes. It's easy to lose track of changes. Prior to changing a submodule, check out a branch. Typically the same branch as the master repository, although for projects imported from other sources we often use the moonshot branch for our local change. As of early 2014,, we're using the tr-integ branch for freeradius.
+
+In all cases, we're using the debian branch for debian packaging.
+
+## When you have something worth saving.
+
+If you have something working well enough to include in the master repository then:
+
+1. commit to the subproject
+
+2. push the branch containing the commit in the submodule.
+
+3. Run "git log origin/branchname" in the submodule and make sure your commit is there
+4. Run "git add submodule_directory" in the master repostiory
+
+4. Commit the master repository
+
+5. Push the branch in the master repository