[DOCS] Dashboard-first docs refresh #76194

KOTungseth · 2020-08-27T20:47:08Z

Summary

This PR:

Checklist

Documentation was added for features that require explanation or tutorials

elasticmachine · 2020-08-27T20:47:11Z

Pinging @elastic/kibana-docs (Team:Docs)

ThomThomson

It's great that we're being proactive about updating the documentation with the dashboard first changes. There will be more coming down the pipe in the future, but this does a great job bringing it up to the present.

I left some minor comments on wording, but it's looking great overall!

docs/getting-started/tutorial-sample-data.asciidoc

docs/user/dashboard/dashboard.asciidoc

docs/user/dashboard/edit-dashboards.asciidoc

docs/getting-started/tutorial-discovering.asciidoc

docs/getting-started/tutorial-sample-data.asciidoc

docs/getting-started/tutorial-visualizing.asciidoc

docs/user/dashboard/explore-dashboard-data.asciidoc

gchaps · 2020-08-31T19:18:38Z

docs/user/dashboard/share-dashboards.asciidoc

+== Share dashboards
+
+[[embedding-dashboards]]
+Share your dashboard outside of {kib}.


Maybe include a screenshot?

What should I include in the screenshot?

docs/user/reporting/index.asciidoc

docs/user/security/reporting.asciidoc

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

ThomThomson

Wording, and instructions LGTM! Thanks for clarifying that panel title changes are not propagated to other dashboards.

docs/getting-started/tutorial-discovering.asciidoc

wylieconlon · 2020-09-03T19:49:29Z

docs/getting-started/tutorial-sample-data.asciidoc

 +
-The `OriginCityName` and the `DestCityName` fields filter the data on the dasbhoard to match 
-the data you specified. 
+You'll see a histogram that shows the distribution of 


Do users understand what histograms are? We use this word in many places in Kibana, so it's probably okay, but worth pointing out.

I believe histogram is considered an industry term, and we use it in the Discover docs, but I think you're right -- we could probably use something a bit more user friendly. Like bar graph, graph, visualization, or something.

docs/getting-started/tutorial-sample-data.asciidoc

wylieconlon · 2020-09-03T19:58:03Z

docs/getting-started/tutorial-sample-data.asciidoc

-[float]
-[[tutorial-sample-discover]]
-=== Discover the data
+. To change the data on the panel, use an {es} {ref}/search-aggregations.html[bucket aggregation],  


Instead of providing the .html name of the other page, can you use the << style of linking?

We use the << style for content in the Kibana repo. The bucket aggregation link is for the ES repo, so we use the .html linking.

docs/getting-started/tutorial-sample-data.asciidoc

docs/user/dashboard/dashboard.asciidoc

wylieconlon · 2020-09-03T20:18:59Z

docs/user/dashboard/dashboard.asciidoc

+
+[float]
+[[timelion]]
+=== Create panels with Timelion


I thought we already made the decision to deprecate Timelion. It surprises me that it's listed here

We deprecated the Timelion app, but not the Timelion editor.

docs/user/dashboard/edit-dashboards.asciidoc

wylieconlon · 2020-09-03T20:21:42Z

docs/user/dashboard/share-dashboards.asciidoc

+* Generate a PNG report
+
+TIP: To create a link to a dashboard by title, use: +
+`${domain}/${basepath?}/app/dashboards#/list?title=${yourdashboardtitle}`


I'm not sure this tip is helpful without also explaining what each of these properties is, or giving examples

wylieconlon · 2020-09-03T20:22:11Z

docs/user/dashboard/tutorials.asciidoc

-[[vega-graph]]
-== Vega
+[[tutorials]]
+== Tutorials


Why are there three timelion tutorials here?

They were in the original docs that Alex wrote, so I just transferred them all over.

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

…h/kibana into docs/dashboard-refresh

* [DOCS] Dashboard-first refresh * Fixes broken links and partinto error * Fixes images in panel table * Fixes broken links * Fixes broken drilldowns link * Fixes images and table * Removed un needed files and added edit content * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> * Review comments * Review comments * Removed blocks * Typo fix * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-discovering.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/edit-dashboards.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/aggregation-reference.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Review comments Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> # Conflicts: # docs/user/visualize.asciidoc # docs/visualize/heatmap.asciidoc

@ts-expect-error

…rok/new-patterns-component-use-array * 'master' of github.com:elastic/kibana: (75 commits) Remove legacy ui-apps-mixin (elastic#76604) remove unused test_utils (elastic#76528) [ML] Functional tests - add UI permission tests (elastic#76368) [APM] @ts-error -> @ts-expect-error (elastic#76492) [APM] Avoid negative offset for error marker on timeline (elastic#76638) [Reporting] rename interfaces to align with task manager integration (elastic#76716) Revert back ESO migration for alerting, added try/catch logic to avoid failing Kibana on start (elastic#76220) Test reverting "Add plugin status API (elastic#75819)" (elastic#76707) [Security Solution][Detections] Removes ML Job Settings SIEM copy and fixes link to ML app for creating custom jobs (elastic#76595) [Maps] remove region/coordinate-maps visualizations from sample data (elastic#76399) [DOCS] Dashboard-first docs refresh (elastic#76194) Updated ServiceNow description in docs and actions management UI to contains correct info (elastic#76344) [DOCS] Identifies cloud settings in reporting (elastic#76691) [Security Solution] Refactor timeline details to use search strategy (elastic#75591) es-archiver: Drop invalid index settings, support --query flag (elastic#76522) [DOCS] Identifies graph settings available on cloud (elastic#76661) Add more info about a11y tests (elastic#76045) [data.search.SearchSource] Remove legacy ES client APIs. (elastic#75943) [release notes] automatically retry on Github API 5xx errors (elastic#76447) [es_ui_shared] Fix eslint exhaustive deps rule (elastic#76392) ...

* [DOCS] Dashboard-first refresh * Fixes broken links and partinto error * Fixes images in panel table * Fixes broken links * Fixes broken drilldowns link * Fixes images and table * Removed un needed files and added edit content * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> * Review comments * Review comments * Removed blocks * Typo fix * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-discovering.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/edit-dashboards.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/aggregation-reference.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Review comments Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> # Conflicts: # docs/user/visualize.asciidoc # docs/visualize/heatmap.asciidoc

KOTungseth added 3 commits August 25, 2020 15:49

[DOCS] Dashboard-first refresh

99b56fd

Merge branch 'master' into docs/dashboard-refresh

31b4134

Fixes broken links and partinto error

d1f3998

KOTungseth added Team:Docs release_note:skip Skip the PR/issue when compiling release notes v7.10.0 v7.11.0 labels Aug 27, 2020

KOTungseth self-assigned this Aug 27, 2020

KOTungseth requested review from gchaps, rayafratkina, ThomThomson, majagrubic and AlonaNadler August 27, 2020 20:47

KOTungseth added 3 commits August 27, 2020 16:30

Fixes images in panel table

1d7e5e5

Fixes broken links

1aa4728

Fixes broken drilldowns link

95dd351

KOTungseth requested review from wylieconlon, ryankeairns, timductive and timroes August 27, 2020 22:00

Fixes images and table

da82b81

ThomThomson reviewed Aug 31, 2020

View reviewed changes

Removed un needed files and added edit content

0df55af

gchaps reviewed Aug 31, 2020

View reviewed changes

KOTungseth and others added 4 commits August 31, 2020 15:27

Update docs/getting-started/tutorial-visualizing.asciidoc

dcc824d

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

Review comments

d2bb346

Review comments

48403d3

Review comment

84fdb33

KOTungseth requested a review from dej611 September 3, 2020 14:20

KOTungseth added 2 commits September 3, 2020 09:50

Removed blocks

b6b66f8

Typo fix

6f0a2a0

ThomThomson approved these changes Sep 3, 2020

View reviewed changes

wylieconlon reviewed Sep 3, 2020

View reviewed changes

KOTungseth and others added 10 commits September 3, 2020 15:26

Update docs/getting-started/tutorial-sample-data.asciidoc

229de23

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/getting-started/tutorial-discovering.asciidoc

0ef997c

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/getting-started/tutorial-sample-data.asciidoc

d3319c2

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/getting-started/tutorial-visualizing.asciidoc

c610d6c

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/user/dashboard/edit-dashboards.asciidoc

4a430d7

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/user/dashboard/dashboard.asciidoc

008b364

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/user/dashboard/dashboard.asciidoc

3d6f366

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Update docs/user/dashboard/aggregation-reference.asciidoc

b6fe3ae

Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>

Review comments

45ffaea

Merge branch 'docs/dashboard-refresh' of https://github.com/KOTungset…

e2b3c9d

…h/kibana into docs/dashboard-refresh

KOTungseth merged commit c84532a into elastic:master Sep 3, 2020

KOTungseth deleted the docs/dashboard-refresh branch September 3, 2020 21:34

KOTungseth mentioned this pull request Sep 3, 2020

[7.x] [DOCS] Dashboard-first docs refresh (#76194) #76717

Merged

KOTungseth mentioned this pull request Sep 4, 2020

[7.9] [DOCS] Dashboard-first docs refresh (#76194) #76773

Closed

This was referenced Jan 4, 2021

Broken documentation link in Visualize app #85176

Closed

Fix broken documentation link in Visualize app #87250

Merged

nreese mentioned this pull request Jan 15, 2021

[Docs] clean-up vega map reference documenation #88487

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[DOCS] Dashboard-first docs refresh #76194

[DOCS] Dashboard-first docs refresh #76194

KOTungseth commented Aug 27, 2020 •

edited

elasticmachine commented Aug 27, 2020

ThomThomson left a comment

gchaps Aug 31, 2020

KOTungseth Sep 1, 2020

ThomThomson left a comment

wylieconlon Sep 3, 2020

KOTungseth Sep 3, 2020

wylieconlon Sep 3, 2020

KOTungseth Sep 3, 2020 •

edited

wylieconlon Sep 3, 2020

KOTungseth Sep 3, 2020

wylieconlon Sep 3, 2020

wylieconlon Sep 3, 2020

KOTungseth Sep 3, 2020

[DOCS] Dashboard-first docs refresh #76194

[DOCS] Dashboard-first docs refresh #76194

Conversation

KOTungseth commented Aug 27, 2020 • edited

Summary

Checklist

elasticmachine commented Aug 27, 2020

ThomThomson left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ThomThomson left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

KOTungseth Sep 3, 2020 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

KOTungseth commented Aug 27, 2020 •

edited

KOTungseth Sep 3, 2020 •

edited