diff --git a/aio/tools/transforms/angular-api-package/tag-defs/internal.js b/aio/tools/transforms/angular-api-package/tag-defs/internal.js
index f981361298..39be3e5389 100644
--- a/aio/tools/transforms/angular-api-package/tag-defs/internal.js
+++ b/aio/tools/transforms/angular-api-package/tag-defs/internal.js
@@ -1,5 +1,16 @@
+/**
+ * Use this tag to ensure that dgeni does not include this code item
+ * in the rendered docs.
+ *
+ * The `@internal` tag indicates to the compiler not to include the
+ * item in the public typings file.
+ * Use the `@nodoc` alias if you only want to hide the item from the
+ * docs but not from the typings file.
+ */
 module.exports = function() {
   return {
-    name: 'internal', transforms: function() { return true; }
+    name: 'internal',
+    aliases: ['nodoc'],
+    transforms: function() { return true; }
   };
 };