From 2e255a64462d6d2497a98ad5bb7b9aeb2d0b3fdf 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 5aca8cb56c2..0a2840b02e7 100644
--- a/docs/README.asciidoc
+++ b/docs/README.asciidoc
@@ -60,6 +60,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.