[DOCS] Move watcher to docs folder

docs/build.gradle

@@ -33,6 +33,9 @@ buildRestTests.expectedUnconvertedCandidates = [
         'reference/ml/apis/post-data.asciidoc',
         'reference/ml/apis/revert-snapshot.asciidoc',
         'reference/ml/apis/update-snapshot.asciidoc',
+        'reference/watcher/apis/put-watch.asciidoc',
+        'reference/watcher/apis/stats.asciidoc',
+        'reference/watcher/example-watches/watching-time-series-data.asciidoc',
 ]
 
 integTestCluster {
@@ -101,6 +104,7 @@ buildRestTests.docs = fileTree(projectDir) {
   exclude 'reference/rollup/apis/delete-job.asciidoc'
   exclude 'reference/rollup/apis/get-job.asciidoc'
   exclude 'reference/rollup/apis/rollup-caps.asciidoc'
+  exclude 'reference/watcher/reference/actions.asciidoc'
 }
 
 listSnippets.docs = buildRestTests.docs
@@ -1096,5 +1100,40 @@ buildRestTests.setups['calendar_outages_addevent'] = buildRestTests.setups['cale
            { "description": "event 3", "start_time": "1514160000000", "end_time": "1514246400000"}
            ]}
 '''
-
-
+buildRestTests.setups['my_inactive_watch'] = '''
+  - do:
+      xpack.watcher.put_watch:
+        id: "my_watch"
+        active: false
+        body:  >
+          {
+            "trigger": {
+              "schedule": {
+                "hourly": {
+                  "minute": [ 0, 5 ]
+                }
+              }
+            },
+            "input": {
+              "simple": {
+                "payload": {
+                  "send": "yes"
+                }
+              }
+            },
+            "condition": {
+              "always": {}
+            },
+            "actions": {
+              "test_index": {
+                "index": {
+                  "index": "test",
+                  "doc_type": "test2"
+                }
+              }
+            }
+          }
+  - match: { _id: "my_watch" }
+'''
+buildRestTests.setups['my_active_watch'] = buildRestTests.setups['my_inactive_watch'].replace(
+        'active: false', 'active: true')

docs/reference/rest-api/index.asciidoc

@@ -25,5 +25,5 @@ include::{es-repo-dir}/migration/migration.asciidoc[]
 include::{es-repo-dir}/ml/apis/ml-api.asciidoc[]
 include::{es-repo-dir}/rollup/rollup-api.asciidoc[]
 include::{xes-repo-dir}/rest-api/security.asciidoc[]
-include::{xes-repo-dir}/rest-api/watcher.asciidoc[]
+include::{es-repo-dir}/watcher/apis/watcher-api.asciidoc[]
 include::defs.asciidoc[]

x-pack/docs/en/watcher/actions.asciidoc → docs/reference/watcher/actions.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions]]
 == Actions
 
@@ -91,6 +93,7 @@ PUT _xpack/watcher/watch/error_logs_alert
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 <1> There will be at least 15 minutes between subsequent `email_administrator`
 		action executions.
 <2> See <<actions-email, Email Action>> for more information.
@@ -150,6 +153,7 @@ PUT _xpack/watcher/watch/log_event_watch
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:skip:non-compliant license]
 
 <1> There will be at least 15 minutes between subsequent action executions
 		(applies to both `email_administrator` and `notify_pager` actions)
@@ -255,32 +259,33 @@ PUT _xpack/watcher/watch/log_event_watch
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 
 <1> A `condition` that only applies to the `notify_pager` action, which
     restricts its execution to when the condition succeeds (at least 5 hits in this case).
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/email.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/email.asciidoc
 include::actions/email.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/webhook.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/webhook.asciidoc
 include::actions/webhook.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/index.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/index.asciidoc
 include::actions/index.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/logging.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/logging.asciidoc
 include::actions/logging.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/hipchat.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/hipchat.asciidoc
 include::actions/hipchat.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/slack.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/slack.asciidoc
 include::actions/slack.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/pagerduty.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/pagerduty.asciidoc
 include::actions/pagerduty.asciidoc[]
 
-:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/actions/jira.asciidoc
+:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/docs/reference/watcher/actions/jira.asciidoc
 include::actions/jira.asciidoc[]
 
 [float]

x-pack/docs/en/watcher/actions/email.asciidoc → docs/reference/watcher/actions/email.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-email]]
 === Email Action
 

x-pack/docs/en/watcher/actions/hipchat.asciidoc → docs/reference/watcher/actions/hipchat.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-hipchat]]
 === HipChat Action
 

x-pack/docs/en/watcher/actions/index.asciidoc → docs/reference/watcher/actions/index.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-index]]
 === Index Action
 

x-pack/docs/en/watcher/actions/jira.asciidoc → docs/reference/watcher/actions/jira.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-jira]]
 === Jira Action
 

x-pack/docs/en/watcher/actions/logging.asciidoc → docs/reference/watcher/actions/logging.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-logging]]
 === Logging Action
 

x-pack/docs/en/watcher/actions/pagerduty.asciidoc → docs/reference/watcher/actions/pagerduty.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-pagerduty]]
 === PagerDuty Action
 

x-pack/docs/en/watcher/actions/slack.asciidoc → docs/reference/watcher/actions/slack.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-slack]]
 === Slack Action
 

x-pack/docs/en/watcher/actions/webhook.asciidoc → docs/reference/watcher/actions/webhook.asciidoc

@@ -1,3 +1,5 @@
+[role="xpack"]
+[testenv="gold"]
 [[actions-webhook]]
 === Webhook Action
 

x-pack/docs/en/rest-api/watcher/ack-watch.asciidoc → docs/reference/watcher/apis/ack-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-ack-watch]]
 === Ack Watch API
 
@@ -83,6 +84,7 @@ watch definition when you call the <<watcher-api-get-watch, Get Watch API>>:
 GET _xpack/watcher/watch/my_watch
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 
 The action state of a newly-created watch is `awaits_successful_execution`:
 
@@ -229,6 +231,7 @@ comma-separated list of action ids:
 POST _xpack/watcher/watch/my_watch/_ack/action1,action2
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 
 To acknowledge all of the actions of a watch, simply omit the `actions`
 parameter:
@@ -237,8 +240,13 @@ parameter:
 --------------------------------------------------
 POST _xpack/watcher/watch/my_watch/_ack
 --------------------------------------------------
-// TEST[s/^/POST _xpack\/watcher\/watch\/my_watch\/_execute\n{ "record_execution" : true }\n/]
 // CONSOLE
+// TEST[skip:non-compliant license]
+
+////
+//After testing is re-enabled:
+// [s/^/POST _xpack\/watcher\/watch\/my_watch\/_execute\n{ "record_execution" : true }\n/]
+////
 
 
 The response looks like a get watch response, but only contains the status:

x-pack/docs/en/rest-api/watcher/activate-watch.asciidoc → docs/reference/watcher/apis/activate-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-activate-watch]]
 === Activate Watch API
 
@@ -34,7 +35,7 @@ call the <<watcher-api-get-watch, Get Watch API>>:
 GET _xpack/watcher/watch/my_watch
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_inactive_watch]
+// TEST[skip:non-compliant license, setup my_inactive_watch]
 
 [source,js]
 --------------------------------------------------
@@ -65,7 +66,7 @@ You can activate the watch by executing the following API call:
 PUT _xpack/watcher/watch/my_watch/_activate
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_inactive_watch]
+// TEST[skip:non-compliant license, setup my_inactive_watch]
 
 The new state of the watch is returned as part of its overall status:
 

x-pack/docs/en/rest-api/watcher/deactivate-watch.asciidoc → docs/reference/watcher/apis/deactivate-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-deactivate-watch]]
 === Deactivate Watch API
 
@@ -33,7 +34,7 @@ call the <<watcher-api-get-watch, Get Watch API>>:
 GET _xpack/watcher/watch/my_watch
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 [source,js]
 --------------------------------------------------
@@ -64,7 +65,7 @@ You can deactivate the watch by executing the following API call:
 PUT _xpack/watcher/watch/my_watch/_deactivate
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 The new state of the watch is returned as part of its overall status:
 

x-pack/docs/en/rest-api/watcher/delete-watch.asciidoc → docs/reference/watcher/apis/delete-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-delete-watch]]
 === Delete Watch API
 
@@ -45,7 +46,7 @@ The following example deletes a watch with the `my-watch` id:
 DELETE _xpack/watcher/watch/my_watch
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 Response:
 

x-pack/docs/en/rest-api/watcher/execute-watch.asciidoc → docs/reference/watcher/apis/execute-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-execute-watch]]
 === Execute Watch API
 
@@ -140,7 +141,7 @@ The following example executes the `my_watch` watch:
 POST _xpack/watcher/watch/my_watch/_execute
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 The following example shows a comprehensive example of executing the `my-watch` watch:
 
@@ -163,7 +164,7 @@ POST _xpack/watcher/watch/my_watch/_execute
 }
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 <1> The triggered and schedule times are provided.
 <2> The input as defined by the watch is ignored and instead the provided input
     is used as the execution payload.
@@ -298,7 +299,7 @@ POST _xpack/watcher/watch/my_watch/_execute
 }
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 You can also associate a single execution mode with all the actions in the watch
 using `_all` as the action id:
@@ -313,7 +314,7 @@ POST _xpack/watcher/watch/my_watch/_execute
 }
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 The following example shows how to execute a watch inline:
 
@@ -349,6 +350,7 @@ POST _xpack/watcher/watch/_execute
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 
 All other settings for this API still apply when inlining a watch. In the
 following snippet, while the inline watch defines a `compare` condition,
@@ -387,3 +389,4 @@ POST _xpack/watcher/watch/_execute
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]

x-pack/docs/en/rest-api/watcher/get-watch.asciidoc → docs/reference/watcher/apis/get-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-get-watch]]
 === Get Watch API
 
@@ -32,7 +33,7 @@ The following example gets a watch with `my-watch` id:
 GET _xpack/watcher/watch/my_watch
 --------------------------------------------------
 // CONSOLE
-// TEST[setup:my_active_watch]
+// TEST[skip:non-compliant license, setup my_active_watch]
 
 Response:
 

x-pack/docs/en/rest-api/watcher/put-watch.asciidoc → docs/reference/watcher/apis/put-watch.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-put-watch]]
 === Put Watch API
 
@@ -143,6 +144,7 @@ PUT _xpack/watcher/watch/my-watch
 }
 --------------------------------------------------
 // CONSOLE
+// TEST[skip:non-compliant license]
 
 When you add a watch you can also define its initial
 {xpack-ref}/how-watcher-works.html#watch-active-state[active state]. You do that

x-pack/docs/en/rest-api/watcher/start.asciidoc → docs/reference/watcher/apis/start.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-start]]
 === Start API
 

x-pack/docs/en/rest-api/watcher/stats.asciidoc → docs/reference/watcher/apis/stats.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-stats]]
 === Stats API
 

x-pack/docs/en/rest-api/watcher/stop.asciidoc → docs/reference/watcher/apis/stop.asciidoc

@@ -1,4 +1,5 @@
 [role="xpack"]
+[testenv="gold"]
 [[watcher-api-stop]]
 === Stop API