From cabb2193e141bc58b3712581058bd2cdcddf5504 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 7c41b4c2a539a..33f060bace57c 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.