Issue 1566 Advice on bugging "can't access dead object" errors

src/content/documentation/develop/debugging.md

@@ -428,6 +428,33 @@ For more details, see [Testing persistent and restart features](/documentation/d
 
 <!-- END: Single Column Body Module -->
 
+<!-- Single Column Body Module -->
+
+{% capture content %}
+
+## Resolving "can't access dead object" errors
+
+Extensions are prevented from keeping references to DOM objects after their parent document is destroyed. This prevents memory leaks in extensions.
+
+If your extension references a nonexistent DOM object, you get an error message similar to this in the Console:
+
+```
+Error: TypeError: can't access dead object
+Source File: chrome://addon/content/file.js
+Line: 42
+```
+
+To correct this, store the data needed the first time it's retrieved rather than look it up later (when the reference is no longer valid).
+
+{% endcapture %}
+{% include modules/one-column.liquid,
+  id: "cant-access-dead-object"
+  content: content
+%}
+
+<!-- END: Single Column Body Module -->
+
+
 <!-- Single Column Body Module -->
 
 {% capture content %}