OpenSearch/docs/painless/painless-guide
Nik Everett d5ad86dad9
Build: Enable testing without magic comments (backports #46180) (#46325)
Previously we only turned on tests if we saw either `// CONSOLE` or
`// TEST`. These magic comments are difficult for the docs build to deal
with so it has moved away from using them where possible. We should
catch up. This adds another trigger to enable testing: marking a snippet
with the `console` language. It looks like this:

```
[source,console]
----
GET /
----
```

This saves a line which is nice, I guess. But it is more important to me
that this is consistent with the way the docs build works now.

Similarly this enables response testing when you mark a snippet with the
language `console-result`. That looks like:
```
[source,console-result]
----
{
  "result": "0.1"
}
----
```

`// TESTRESPONSE` is still available for situations like `// TEST`: when
the response isn't *in* the console-result language (like `_cat`) or
when you want to perform substitutions on the generated test.

Should unblock #46159.
2019-09-04 15:19:20 -04:00
..
index.asciidoc [DOCS] Add redirect for painless examples anchor 2019-06-25 12:34:18 -04:00
painless-datetime.asciidoc Add several context examples for Painless date documentation (#44985) 2019-07-31 08:23:17 -07:00
painless-debugging.asciidoc Reorganize Painless doc structure (#42303) 2019-05-21 10:50:21 -07:00
painless-execute-script.asciidoc Build: Enable testing without magic comments (backports #46180) (#46325) 2019-09-04 15:19:20 -04:00
painless-method-dispatch.asciidoc Reorganize Painless doc structure (#42303) 2019-05-21 10:50:21 -07:00
painless-walkthrough.asciidoc Reorganize Painless doc structure (#42303) 2019-05-21 10:50:21 -07:00