fix(ngTransclude): detect ngTranslude usage without a transclusion directive

Closes #3759

1 files changed, 12 insertions, 0 deletions

diff --git a/docs/content/error/ngTransclude/orphan.ngdoc b/docs/content/error/ngTransclude/orphan.ngdoc
new file mode 100644
index 00000000..5ac25432
--- /dev/null
+++ b/docs/content/error/ngTransclude/orphan.ngdoc
@@ -0,0 +1,12 @@
+@ngdoc error
+@name ngTransclude:orphan
+@fullName Orphan ngTransclude Directive
+@description
+
+Occurs when an `ngTransclude` occurs without a transcluded ancesstor element.
+
+This error often occurs when you have forgotten to set `transclude: true` in some directive definition, and then used `ngTranslude` in the driective's template.
+
+To resolve, either remove the offending `ngTransclude` or check that `transclude: true` is included in the intended directive definition.
+
+Consult the API documentation for {@link guide/directive writing directives} to learn more.