diff --git a/googletest/docs/advanced.md b/googletest/docs/advanced.md
index f667532f..32819b6b 100644
--- a/googletest/docs/advanced.md
+++ b/googletest/docs/advanced.md
@@ -911,6 +911,12 @@ handlers registered with `pthread_atfork(3)`.
 
 ## Using Assertions in Sub-routines
 
+Note: If you want to put a series of test assertions in a subroutine to check
+for a complex condition, consider using
+[a custom GMock matcher](../../googlemock/docs/cook_book.md#NewMatchers)
+instead. This lets you provide a more readable error message in case of failure
+and avoid all of the issues described below.
+
 ### Adding Traces to Assertions
 
 If a test sub-routine is called from several places, when an assertion inside it