diff --git a/gulp-minify-html/gulp-minify-html-tests.ts b/gulp-minify-html/gulp-minify-html-tests.ts
index 556ee203b..1b3c7639d 100644
--- a/gulp-minify-html/gulp-minify-html-tests.ts
+++ b/gulp-minify-html/gulp-minify-html-tests.ts
@@ -4,6 +4,8 @@
 import * as gulp from 'gulp';
 import * as minifyHtml from 'gulp-minify-html';
 
+// This package has been deprecated in favor of gulp-htmlmin, which should be faster and more comprehensive.
+
 minifyHtml();
 minifyHtml({conditionals: true, loose: true});
 
diff --git a/gulp-minify-html/gulp-minify-html.d.ts b/gulp-minify-html/gulp-minify-html.d.ts
index 321a56925..770789bbb 100644
--- a/gulp-minify-html/gulp-minify-html.d.ts
+++ b/gulp-minify-html/gulp-minify-html.d.ts
@@ -5,8 +5,11 @@
 
 /// <reference path="../node/node.d.ts" />
 
+// This package has been deprecated in favor of gulp-htmlmin, which should be faster and more comprehensive.
+
 declare module 'gulp-minify-html' {
     namespace minifyHtml {
+        // Options from https://github.com/Swaagie/minimize#options
         interface Options {
             // Do not remove empty attributes
             empty?: boolean;