[6.8][DOCS] Adds user folder (#45411) (#45469)

docs/getting-started.asciidoc

@@ -1,58 +0,0 @@
-[[getting-started]]
-= Getting Started
-
-[partintro]
---
-
-Ready to get some hands-on experience with {kib}? There are two ways to start:
-
-* <<tutorial-sample-data, Explore {kib} using the Flights dashboard>>
-+
-Load the Flights sample data and dashboard with one click and start 
-interacting with {kib} visualizations in seconds.
-
-* <<tutorial-build-dashboard, Build your own dashboard>> 
-+
-Manually load a data set and build your own visualizations and dashboard.
-
-Before you begin, make sure you've <<install, installed Kibana>> and established
-a {kibana-ref}/connect-to-elasticsearch.html[connection to Elasticsearch].
-You might also be interested in the
-https://www.elastic.co/webinars/getting-started-kibana[Getting Started with Kibana]
-video tutorial.
-
-If you are running our https://cloud.elastic.co[hosted Elasticsearch Service] 
-on Elastic Cloud, you can access Kibana with a single click.
---
-
-include::getting-started/add-sample-data.asciidoc[]
-
-include::getting-started/tutorial-sample-data.asciidoc[]
-
-include::getting-started/tutorial-sample-filter.asciidoc[]
-
-include::getting-started/tutorial-sample-query.asciidoc[]
-
-include::getting-started/tutorial-sample-discover.asciidoc[]
-
-include::getting-started/tutorial-sample-edit.asciidoc[]
-
-include::getting-started/tutorial-sample-inspect.asciidoc[]
-
-include::getting-started/tutorial-sample-remove.asciidoc[]
-
-include::getting-started/tutorial-full-experience.asciidoc[]
-
-include::getting-started/tutorial-load-dataset.asciidoc[]
-
-include::getting-started/tutorial-define-index.asciidoc[]
-
-include::getting-started/tutorial-discovering.asciidoc[]
-
-include::getting-started/tutorial-visualizing.asciidoc[]
-
-include::getting-started/tutorial-dashboard.asciidoc[]
-
-include::getting-started/tutorial-inspect.asciidoc[]
-
-include::getting-started/wrapping-up.asciidoc[]

docs/index.asciidoc

@@ -20,63 +20,7 @@ include::{asciidoc-dir}/../../shared/versions/stack/{source_branch}.asciidoc[]
 
 include::{asciidoc-dir}/../../shared/attributes.asciidoc[]
 
-include::introduction.asciidoc[]
-
-include::setup.asciidoc[]
-
-include::monitoring/configuring-monitoring.asciidoc[]
-
-include::security/securing-kibana.asciidoc[]
-
-include::settings/settings-xkb.asciidoc[]
-
-include::getting-started.asciidoc[]
-
-include::discover.asciidoc[]
-
-include::visualize.asciidoc[]
-
-include::dashboard.asciidoc[]
-
-include::timelion.asciidoc[]
-
-include::canvas.asciidoc[]
-
-include::ml/index.asciidoc[]
-
-include::maps/index.asciidoc[]
-
-include::infrastructure/index.asciidoc[]
-
-include::logs/index.asciidoc[]
-
-include::apm/index.asciidoc[]
-
-include::uptime/index.asciidoc[]
-
-include::graph/index.asciidoc[]
-
-include::dev-tools.asciidoc[]
-
-include::monitoring/index.asciidoc[]
-
-include::management.asciidoc[]
-
-include::spaces/index.asciidoc[]
-
-include::security/index.asciidoc[]
-
-include::management/watcher-ui/index.asciidoc[]
-
-include::management/upgrade-assistant/index.asciidoc[]
-
-include::management/dashboard_only_mode/index.asciidoc[]
-
-include::reporting/index.asciidoc[]
-
-include::api.asciidoc[]
-
-include::plugins.asciidoc[]
+include::user/index.asciidoc[]
 
 include::limitations.asciidoc[]
 

docs/management.asciidoc

@@ -1,45 +0,0 @@
-[[management]]
-= Management
-
-[partintro]
---
-The Management application is where you perform your runtime configuration of
-Kibana, including both the initial setup and ongoing configuration of index
-patterns, advanced settings that tweak the behaviors of Kibana itself, and
-the various "objects" that you can save throughout Kibana such as searches,
-visualizations, and dashboards.
-
---
-
-include::management/managing-licenses.asciidoc[]
-
-include::management/index-patterns.asciidoc[]
-
-include::management/rollups/create_and_manage_rollups.asciidoc[]
-
-include::management/rollups/visualize_rollup_data.asciidoc[]
-
-include::management/index-lifecycle-policies/intro-to-lifecycle-policies.asciidoc[]
-
-include::management/index-lifecycle-policies/create-policy.asciidoc[]
-
-include::management/index-lifecycle-policies/manage-policy.asciidoc[]
-
-include::management/index-lifecycle-policies/add-policy-to-index.asciidoc[]
-
-include::management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc[]
-
-include::management/managing-fields.asciidoc[]
-
-include::management/managing-indices.asciidoc[]
-
-include::management/advanced-options.asciidoc[]
-
-include::management/managing-saved-objects.asciidoc[]
-
-include::management/managing-beats.asciidoc[]
-
-include::management/managing-remote-clusters.asciidoc[]
-
-
-

docs/user/api.asciidoc

@@ -35,10 +35,10 @@ entirely.
 * <<upgrade-assistant-api>>
 --
 
-include::api/spaces-management.asciidoc[]
-include::api/role-management.asciidoc[]
-include::api/saved-objects.asciidoc[]
-include::api/dashboard-import.asciidoc[]
-include::api/logstash-configuration-management.asciidoc[]
-include::api/url-shortening.asciidoc[]
-include::api/upgrade-assistant.asciidoc[]
+include::{kib-repo-dir}/api/spaces-management.asciidoc[]
+include::{kib-repo-dir}/api/role-management.asciidoc[]
+include::{kib-repo-dir}/api/saved-objects.asciidoc[]
+include::{kib-repo-dir}/api/dashboard-import.asciidoc[]
+include::{kib-repo-dir}/api/logstash-configuration-management.asciidoc[]
+include::{kib-repo-dir}/api/url-shortening.asciidoc[]
+include::{kib-repo-dir}/api/upgrade-assistant.asciidoc[]

docs/user/canvas.asciidoc

@@ -29,16 +29,16 @@ Canvas, see the <<canvas-common-functions>> and
 
 --
 
-include::canvas/canvas-getting-started.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-getting-started.asciidoc[]
 
-include::canvas/canvas-workpad.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-workpad.asciidoc[]
 
-include::canvas/canvas-function-reference.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-function-reference.asciidoc[]
 
-include::canvas/canvas-common-functions.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-common-functions.asciidoc[]
 
-include::canvas/canvas-server-functions.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-server-functions.asciidoc[]
 
-include::canvas/canvas-client-functions.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-client-functions.asciidoc[]
 
-include::canvas/canvas-tinymath-functions.asciidoc[]
+include::{kib-repo-dir}/canvas/canvas-tinymath-functions.asciidoc[]

docs/user/dashboard.asciidoc

@@ -117,4 +117,4 @@ TIP: You can create a link to a dashboard by title by doing this: +
 
 TIP: When sharing a link to a dashboard snapshot, use the *Short URL*. Snapshot
 URLs are long and can be problematic for Internet Explorer and other
-tools.  To create a short URL, you must have write access to {kib}.
+tools.  To create a short URL, you must have write access to {kib}.

docs/user/dev-tools.asciidoc

@@ -14,8 +14,8 @@ with your data in Kibana.
 
 --
 
-include::dev-tools/console/console.asciidoc[]
+include::{kib-repo-dir}/dev-tools/console/console.asciidoc[]
 
-include::dev-tools/searchprofiler/index.asciidoc[]
+include::{kib-repo-dir}/dev-tools/searchprofiler/index.asciidoc[]
 
-include::dev-tools/grokdebugger/index.asciidoc[]
+include::{kib-repo-dir}/dev-tools/grokdebugger/index.asciidoc[]

docs/user/discover.asciidoc

@@ -12,14 +12,14 @@ top of the page.
 image::images/Discover-Start-Annotated.png[Discover]
 --
 
-include::discover/set-time-filter.asciidoc[]
+include::{kib-repo-dir}/discover/set-time-filter.asciidoc[]
 
-include::discover/search.asciidoc[]
+include::{kib-repo-dir}/discover/search.asciidoc[]
 
-include::discover/field-filter.asciidoc[]
+include::{kib-repo-dir}/discover/field-filter.asciidoc[]
 
-include::discover/document-data.asciidoc[]
+include::{kib-repo-dir}/discover/document-data.asciidoc[]
 
-include::discover/context.asciidoc[]
+include::{kib-repo-dir}/discover/context.asciidoc[]
 
-include::discover/viewing-field-stats.asciidoc[]
+include::{kib-repo-dir}/discover/viewing-field-stats.asciidoc[]

docs/user/getting-started.asciidoc

@@ -0,0 +1,58 @@
+[[getting-started]]
+= Getting Started
+
+[partintro]
+--
+
+Ready to get some hands-on experience with {kib}? There are two ways to start:
+
+* <<tutorial-sample-data, Explore {kib} using the Flights dashboard>>
++
+Load the Flights sample data and dashboard with one click and start 
+interacting with {kib} visualizations in seconds.
+
+* <<tutorial-build-dashboard, Build your own dashboard>> 
++
+Manually load a data set and build your own visualizations and dashboard.
+
+Before you begin, make sure you've <<install, installed Kibana>> and established
+a {kibana-ref}/connect-to-elasticsearch.html[connection to Elasticsearch].
+You might also be interested in the
+https://www.elastic.co/webinars/getting-started-kibana[Getting Started with Kibana]
+video tutorial.
+
+If you are running our https://cloud.elastic.co[hosted Elasticsearch Service] 
+on Elastic Cloud, you can access Kibana with a single click.
+--
+
+include::{kib-repo-dir}/getting-started/add-sample-data.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-data.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-filter.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-query.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-discover.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-edit.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-inspect.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-sample-remove.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-full-experience.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-load-dataset.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-define-index.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-discovering.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-visualizing.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-dashboard.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/tutorial-inspect.asciidoc[]
+
+include::{kib-repo-dir}/getting-started/wrapping-up.asciidoc[]

docs/user/index.asciidoc

@@ -0,0 +1,57 @@
+include::introduction.asciidoc[]
+
+include::setup.asciidoc[]
+
+include::{kib-repo-dir}/monitoring/configuring-monitoring.asciidoc[]
+
+include::{kib-repo-dir}/security/securing-kibana.asciidoc[]
+
+include::{kib-repo-dir}/settings/settings-xkb.asciidoc[]
+
+include::getting-started.asciidoc[]
+
+include::discover.asciidoc[]
+
+include::visualize.asciidoc[]
+
+include::dashboard.asciidoc[]
+
+include::timelion.asciidoc[]
+
+include::canvas.asciidoc[]
+
+include::{kib-repo-dir}/ml/index.asciidoc[]
+
+include::{kib-repo-dir}/maps/index.asciidoc[]
+
+include::{kib-repo-dir}/infrastructure/index.asciidoc[]
+
+include::{kib-repo-dir}/logs/index.asciidoc[]
+
+include::{kib-repo-dir}/apm/index.asciidoc[]
+
+include::{kib-repo-dir}/uptime/index.asciidoc[]
+
+include::{kib-repo-dir}/graph/index.asciidoc[]
+
+include::dev-tools.asciidoc[]
+
+include::{kib-repo-dir}/monitoring/index.asciidoc[]
+
+include::management.asciidoc[]
+
+include::{kib-repo-dir}/spaces/index.asciidoc[]
+
+include::{kib-repo-dir}/security/index.asciidoc[]
+
+include::{kib-repo-dir}/management/watcher-ui/index.asciidoc[]
+
+include::{kib-repo-dir}/management/upgrade-assistant/index.asciidoc[]
+
+include::{kib-repo-dir}/management/dashboard_only_mode/index.asciidoc[]
+
+include::{kib-repo-dir}/reporting/index.asciidoc[]
+
+include::api.asciidoc[]
+
+include::plugins.asciidoc[]

docs/user/management.asciidoc

@@ -0,0 +1,44 @@
+[[management]]
+= Management
+
+[partintro]
+--
+The Management application is where you perform your runtime configuration of
+Kibana, including both the initial setup and ongoing configuration of index
+patterns, advanced settings that tweak the behaviors of Kibana itself, and
+the various "objects" that you can save throughout Kibana such as searches,
+visualizations, and dashboards.
+
+--
+
+include::{kib-repo-dir}/management/managing-licenses.asciidoc[]
+
+include::{kib-repo-dir}/management/index-patterns.asciidoc[]
+
+include::{kib-repo-dir}/management/rollups/create_and_manage_rollups.asciidoc[]
+
+include::{kib-repo-dir}/management/rollups/visualize_rollup_data.asciidoc[]
+
+include::{kib-repo-dir}/management/index-lifecycle-policies/intro-to-lifecycle-policies.asciidoc[]
+
+include::{kib-repo-dir}/management/index-lifecycle-policies/create-policy.asciidoc[]
+
+include::{kib-repo-dir}/management/index-lifecycle-policies/manage-policy.asciidoc[]
+
+include::{kib-repo-dir}/management/index-lifecycle-policies/add-policy-to-index.asciidoc[]
+
+include::{kib-repo-dir}/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc[]
+
+include::{kib-repo-dir}/management/managing-fields.asciidoc[]
+
+include::{kib-repo-dir}/management/managing-indices.asciidoc[]
+
+include::{kib-repo-dir}/management/advanced-options.asciidoc[]
+
+include::{kib-repo-dir}/management/managing-saved-objects.asciidoc[]
+
+include::{kib-repo-dir}/management/managing-beats.asciidoc[]
+
+include::{kib-repo-dir}/management/managing-remote-clusters.asciidoc[]
+
+

docs/user/plugins.asciidoc

@@ -153,4 +153,4 @@ you must specify the path to that configuration file each time you use the `bin/
 74:: I/O error
 70:: Other error
 
-include::plugins/known-plugins.asciidoc[]
+include::{kib-repo-dir}/plugins/known-plugins.asciidoc[]

docs/user/setup.asciidoc

@@ -46,22 +46,22 @@ encourage users to run the same versions of Kibana and Elasticsearch down to
 the patch version.
 --
 
-include::setup/install.asciidoc[]
+include::{kib-repo-dir}/setup/install.asciidoc[]
 
-include::setup/start-stop.asciidoc[]
+include::{kib-repo-dir}/setup/start-stop.asciidoc[]
 
-include::setup/settings.asciidoc[]
+include::{kib-repo-dir}/setup/settings.asciidoc[]
 
-include::setup/secure-settings.asciidoc[]
+include::{kib-repo-dir}/setup/secure-settings.asciidoc[]
 
-include::setup/docker.asciidoc[]
+include::{kib-repo-dir}/setup/docker.asciidoc[]
 
-include::setup/access.asciidoc[]
+include::{kib-repo-dir}/setup/access.asciidoc[]
 
-include::setup/connect-to-elasticsearch.asciidoc[]
+include::{kib-repo-dir}/setup/connect-to-elasticsearch.asciidoc[]
 
-include::setup/tribe.asciidoc[]
+include::{kib-repo-dir}/setup/tribe.asciidoc[]
 
-include::setup/production.asciidoc[]
+include::{kib-repo-dir}/setup/production.asciidoc[]
 
-include::setup/upgrade.asciidoc[]
+include::{kib-repo-dir}/setup/upgrade.asciidoc[]

docs/user/timelion.asciidoc

@@ -24,6 +24,6 @@ You might also be interested in these tutorial videos:
 * https://www.elastic.co/videos/using-kibana-and-timelion-to-analyze-earthquake-data[Using Kibana and Timelion to Analyze Earthquake Data]
 --
 
-include::timelion/timelion-getting-started.asciidoc[]
+include::{kib-repo-dir}/timelion/timelion-getting-started.asciidoc[]
 
-include::timelion/timelion-inline-help.asciidoc[]
+include::{kib-repo-dir}/timelion/timelion-inline-help.asciidoc[]

docs/user/visualize.asciidoc

@@ -138,30 +138,30 @@ For more information about working with sub aggregations, see
 https://www.elastic.co/blog/kibana-aggregation-execution-order-and-you[Kibana,
 Aggregation Execution Order, and You].
 
-include::visualize/xychart.asciidoc[]
+include::{kib-repo-dir}/visualize/xychart.asciidoc[]
 
-include::visualize/controls.asciidoc[]
+include::{kib-repo-dir}/visualize/controls.asciidoc[]
 
-include::visualize/datatable.asciidoc[]
+include::{kib-repo-dir}/visualize/datatable.asciidoc[]
 
-include::visualize/markdown.asciidoc[]
+include::{kib-repo-dir}/visualize/markdown.asciidoc[]
 
-include::visualize/metric.asciidoc[]
+include::{kib-repo-dir}/visualize/metric.asciidoc[]
 
-include::visualize/goal.asciidoc[]
+include::{kib-repo-dir}/visualize/goal.asciidoc[]
 
-include::visualize/pie.asciidoc[]
+include::{kib-repo-dir}/visualize/pie.asciidoc[]
 
-include::visualize/tilemap.asciidoc[]
+include::{kib-repo-dir}/visualize/tilemap.asciidoc[]
 
-include::visualize/regionmap.asciidoc[]
+include::{kib-repo-dir}/visualize/regionmap.asciidoc[]
 
-include::visualize/time-series-visual-builder.asciidoc[]
+include::{kib-repo-dir}/visualize/time-series-visual-builder.asciidoc[]
 
-include::visualize/tagcloud.asciidoc[]
+include::{kib-repo-dir}/visualize/tagcloud.asciidoc[]
 
-include::visualize/heatmap.asciidoc[]
+include::{kib-repo-dir}/visualize/heatmap.asciidoc[]
 
-include::visualize/vega.asciidoc[]
+include::{kib-repo-dir}/visualize/vega.asciidoc[]
 
-include::visualize/inspector.asciidoc[]
+include::{kib-repo-dir}/visualize/inspector.asciidoc[]