From 2d1a37687bbf93e916a39159860dc574ee5a4b7b Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 25 Apr 2019 12:51:39 -0400
Subject: [PATCH] [DOCS] Note TESTRESPONSE can't be used immediately after
 TESTSETUP

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

diff --git a/docs/README.asciidoc b/docs/README.asciidoc
index 5aca8cb56c226..0a2840b02e7e4 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.