Selaa lähdekoodia

[DOCS] Document // TEARDOWN test snippet. (#44762)

The `// TEARDOWN` test snippet was added with #34716. You can use this
snippet to end and clean up a test series started with `// TESTSETUP` or
`// TEST[setup:name]`.
James Rodewig 6 vuotta sitten
vanhempi
commit
aca29b6fa4
1 muutettua tiedostoa jossa 5 lisäystä ja 0 poistoa
  1. 5 0
      docs/README.asciidoc

+ 5 - 0
docs/README.asciidoc

@@ -31,6 +31,8 @@ for its modifiers:
   This is most useful when you have text and snippets that work together to
   tell the story of some use case because it merges the snippets (and thus the
   use case) into one big test.
+      * You can't use `// TEST[continued]` immediately after `// TESTSETUP` or
+      `// TEARDOWN`.
   * `// TEST[skip:reason]`: Skip this test. Replace `reason` with the actual
   reason to skip the test. Snippets without `// TEST` or `// CONSOLE` aren't
   considered tests anyway but this is useful for explicitly documenting the
@@ -78,6 +80,9 @@ for its modifiers:
   over `// TEST[setup:name]` because it makes it more clear what steps have to
   be taken before the examples will work. Tip: `// TESTSETUP` can only be used
   on the first snippet of a document.
+* `// TEARDOWN`: Ends and cleans up a test series started with `// TESTSETUP` or
+  `// TEST[setup:name]`. You can use `// TEARDOWN` to set up multiple tests in
+  the same file.
 * `// NOTCONSOLE`: Marks this snippet as neither `// CONSOLE` nor
   `// TESTRESPONSE`, excluding it from the list of unconverted snippets. We
   should only use this for snippets that *are* JSON but are *not* responses or