Timelion deprecation doc (elastic#74508)

* timelion deprecation doc wip * Create Timelion Deprecation section to Visualize * Code review changes * minor changes * Make some changes in order to give priotization on how to replace an existing timelion worksheet to a dashboard * Syntax related improvements * Final touch * Remove extra lines and some minor changes
stratoula · Aug 11, 2020 · 7473182 · 7473182
1 parent 086be78
commit 7473182
Show file tree

Hide file tree

Showing 8 changed files with 42 additions and 0 deletions.
diff --git a/docs/user/visualize.asciidoc b/docs/user/visualize.asciidoc
@@ -132,6 +132,7 @@ include::{kib-repo-dir}/visualize/lens.asciidoc[]
 include::{kib-repo-dir}/visualize/most-frequent.asciidoc[]
 
 include::{kib-repo-dir}/visualize/tsvb.asciidoc[]
+
 include::{kib-repo-dir}/visualize/timelion.asciidoc[]
 
 include::{kib-repo-dir}/visualize/heatmap.asciidoc[]

diff --git a/docs/visualize/images/timelion-add-to-dashboard.png b/docs/visualize/images/timelion-add-to-dashboard.png
diff --git a/docs/visualize/images/timelion-app.png b/docs/visualize/images/timelion-app.png
diff --git a/docs/visualize/images/timelion-copy-expression.png b/docs/visualize/images/timelion-copy-expression.png
diff --git a/docs/visualize/images/timelion-create-new-dashboard.png b/docs/visualize/images/timelion-create-new-dashboard.png
diff --git a/docs/visualize/images/timelion-dashboard.png b/docs/visualize/images/timelion-dashboard.png
diff --git a/docs/visualize/images/timelion-vis-paste-expression.png b/docs/visualize/images/timelion-vis-paste-expression.png
diff --git a/docs/visualize/timelion.asciidoc b/docs/visualize/timelion.asciidoc
@@ -504,3 +504,44 @@ image::images/timelion-conditional04.png[]
 {nbsp}
 
 For additional information on Timelion conditional capabilities, go to https://www.elastic.co/blog/timeseries-if-then-else-with-timelion[I have but one .condition()].
+
+[float]
+[[timelion-deprecation]]
+=== Timelion App deprecation
+
+Deprecated since 7.0, the Timelion app will be removed in 8.0. If you have any Timelion worksheets, you must migrate them to a dashboard.
+
+NOTE: Only the Timelion app is deprecated. {kib} continues to support Timelion visualizations on dashboards, in Visualize, and in Canvas. 
+
+[float]
+[[timelion-app-to-vis]]
+==== Create a dashboard from a Timelion worksheet
+
+To replace a Timelion worksheet with a dashboard, follow the same process for adding a visualization. 
+In addition, you must migrate the Timelion graphs to Visualize.
+
+. Open the menu, click **Dashboard**, then click **Create dashboard**.
+
+. On the dashboard, click **Create New**, then select the Timelion visualization.
++
+[role="screenshot"]
+image::images/timelion-create-new-dashboard.png[]
++
+The only thing you need is the Timelion expression for each graph.
+
+. Open the Timelion app on a new tab, select the chart you want to copy, and copy its expression.
++
+[role="screenshot"]
+image::images/timelion-copy-expression.png[]
+
+. Return to the other tab and paste the copied expression to the *Timelion Expression* field and click **Update**.
++
+[role="screenshot"]
+image::images/timelion-vis-paste-expression.png[]
+
+. Save the new visualization, give it a name, and click **Save and Return**.
++
+Your Timelion visualization will appear on the dashboard. Repeat this for all your charts on each worksheet.
++
+[role="screenshot"]
+image::images/timelion-dashboard.png[]