diff --git a/doc/source/codesearch.rst b/doc/source/codesearch.rst
index 346d572148..a50a0bc3bb 100644
--- a/doc/source/codesearch.rst
+++ b/doc/source/codesearch.rst
@@ -30,3 +30,15 @@ Overview
 Hound is configured to read projects from a config.json file that is
 automatically generated from the Gerrit projects.yaml, defined in the
 $::project_config::jeepyb_project_file variable in Puppet.
+
+
+Maintenance
+===========
+
+Hound uses 'git pull' to keep repos in sync. If a force push is ever used to
+correct an issue in a repo, then hound will not be able to pull or index those
+changes. The only way to detect this is to look in /var/log/hound.log. The
+error message looks like hound attempting to update the repo and getting a
+'remote host hung up' message. The issue can be corrected by an infra-root
+removing the relevant hound data directory. Hound will re-clone with the new
+history.