Add too-much-inference troubleshooting topic

tmcw · tmcw · commit 393002d5c1d1 · 2016-11-11T11:04:28.000-05:00
diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
@@ -4,6 +4,16 @@ Unfortunately, we need to recommend: use **yarn or npm v3** to install documenta
 npm v1 and v2 are unable to properly de-duplicate dependencies, so they will
 create wastefully large `node_modules` directories under documentation.
 
+## documentation is inferring _too much_ about my code
+
+If you've written very dynamic JavaScript, all of documentation's intelligence
+might not understand it. If:
+
+* documentation is **wrong** in a clear way, please [open a descriptive issue](https://github.com/documentationjs/documentation/issues) with a code snippet and we can help!
+* if it's **right** technically but you want to control your docs entirely,
+  use the `@name` tag to declare the name of the thing (function, variable, etc)
+  you're referring to, and the tool will not try to infer anything at all.
+
 ## Error: watch ENOSPC
 
 Linux systems can have a low limit of 'watchable files'. To increase this
