From 6011542038621c3b770bebfa2c1d71299a641579 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 25 Apr 2019 13:58:48 -0400
Subject: [PATCH] [DOCS] Note TESTRESPONSE can't be used immediately after
 TESTSETUP (#41542)

---
 docs/README.asciidoc | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/README.asciidoc b/docs/README.asciidoc
index 5074e2b38e5be..47961c7024d6a 100644
--- a/docs/README.asciidoc
+++ b/docs/README.asciidoc
@@ -57,6 +57,8 @@ for its modifiers:
     "figures out" the path. This is especially useful for making sweeping
     assertions like "I made up all the numbers in this example, don't compare
     them" which looks like `// TESTRESPONSE[s/\d+/$body.$_path/]`.
+  * You can't use `// TESTRESPONSE` immediately after `// TESTSETUP`. Instead,
+  consider using `// TEST[continued]` or rearrange your snippets.
   * `// TESTRESPONSE[_cat]`: Add substitutions for testing `_cat` responses. Use
   this after all other substitutions so it doesn't make other substitutions
   difficult.