diff --git a/docs/index.md b/docs/index.md
index 7bfe5895f1..0937617abb 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -663,6 +663,8 @@ describe('outer', function () {
 });
 ```
 
+Skipping a test within an `after/afterEach` hook is deprecated and will be removed from a future version of Mocha. Use `return` instead to exit hook abortively.
+
 > Before Mocha v3.0.0, `this.skip()` was not supported in asynchronous tests and hooks.
 
 ## Retry Tests