[Lens] [Docs] Add more QA for Lens #97142

dej611 · 2021-04-14T16:18:19Z

Summary

this new batch of Q&A adds some more limitations based on some real forum questions to the Lens page.

I've also tried to fill some missing bits of information within existing answers.
The percentage/filter ratio page is coming through a different PR.

Checklist

Documentation was added for features that require explanation or tutorials

elasticmachine · 2021-04-21T12:36:12Z

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

docs/user/dashboard/lens.asciidoc

mbondyra · 2021-04-27T13:29:44Z

docs/user/dashboard/lens.asciidoc

+
+[float]
+[[why-my-field-x-is-missing-from-the-fields-list]]
+===== Why is my field X missing from the fields list in Lens?


that's a good one, I saw this like 3 times in Discuss forum 👏🏼

docs/user/dashboard/lens.asciidoc

mbondyra · 2021-04-27T13:33:42Z

docs/user/dashboard/lens.asciidoc

+[[is-it-possible-to-change-the-scale-of-Y-axis]]
+===== Is it possible to change the scale of the Y axis in a visualization?
+
+At the moment it is not possible to change the scale of the Y axis (for instance, making it start from another value than 0) in *Lens*.


Nit: Maybe it would be worth mentioning that at the moment we only support linear scale.

Good catch!

docs/user/dashboard/lens.asciidoc

mbondyra

This looks very useful. All my comments are just suggestions that feel more understandable to me so feel free to not use them.

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com>

docs/user/dashboard/lens.asciidoc

KOTungseth · 2021-05-04T15:19:48Z

docs/user/dashboard/lens.asciidoc

 * *Pie*, *Donut*, and *Treemap*
 +
 [role="screenshot"]
 image::images/lens_value_labels_partition_toggle.png[Lens Pie chart value labels menu]

+Other type of visualizations do not support labels yet.


I don't think we need this sentence. In the intro to the section, we already say A subset of **Lens** visualizations support value labels.

KOTungseth · 2021-05-04T15:20:49Z

docs/user/dashboard/lens.asciidoc

@@ -207,7 +211,10 @@ refer to <<explore-fields-in-your-data,Explore the fields in your data>>.
 [[is-it-possible-to-sort-dimensions-in-a-chart]]
 ===== How do I sort the dimensions in a chart?

-Sorting dimensions in visualizations is unsupported in *Lens*.
+Sorting dimensions in visualizations is unsupported in *Lens* for charts.


Suggested change

Sorting dimensions in visualizations is unsupported in *Lens* for charts.

Sorting chart dimensions is unsupported in *Lens*, but you can sort the dimensions for a single column in data tables.

I see the copy is shorter with your version, but it does not sound as clear (to me) as having two distinct sentences.

KOTungseth · 2021-05-04T15:22:37Z

docs/user/dashboard/lens.asciidoc

-Sorting dimensions in visualizations is unsupported in *Lens*.
+Sorting dimensions in visualizations is unsupported in *Lens* for charts.
+
+Sorting is possible in *Lens* datatables, but it is limited to a single column. Click on the column header to sort by the column and select the sorting criteria.


Suggested change

Sorting is possible in *Lens* datatables, but it is limited to a single column. Click on the column header to sort by the column and select the sorting criteria.

To sort the dimension of a single column, click the column header, then select the sorting criteria you want to use.

KOTungseth · 2021-05-04T15:23:20Z

docs/user/dashboard/lens.asciidoc

+Sorting dimensions in visualizations is unsupported in *Lens* for charts.
+
+Sorting is possible in *Lens* datatables, but it is limited to a single column. Click on the column header to sort by the column and select the sorting criteria.
+Note that if the dimension is used within the `Columns` (transposed) then all columns that belong to the same dimension will be sorted.


Suggested change

Note that if the dimension is used within the `Columns` (transposed) then all columns that belong to the same dimension will be sorted.

If the dimension is used within the transposed `Columns`, then all columns that belong to the same dimension are sorted.

Your version sounds better. I guess the only pending issue is to understand how to call the new transposed feature for data tables. I'll check the release notes for some reference.

The definition of transpose is "to change the relative position, order, or sequence of; cause to change places; interchange"

I suggest change this to:

If you use the dimension in the reordered columns, then all columns that belong to the same dimension are sorted.

docs/user/dashboard/lens.asciidoc

KOTungseth · 2021-05-04T15:42:13Z

docs/user/dashboard/lens.asciidoc

+[[is-it-possible-to-have-more-than-one-Y-axis-scale]]
+===== Is it possible to have more than one Y axis scale in visualization?
+
+*Lens* lets you pick, for each Y dimension, up to two distinct axis: *left* and *right*. Each axis can have a different scale.


Suggested change

*Lens* lets you pick, for each Y dimension, up to two distinct axis: *left* and *right*. Each axis can have a different scale.

For each y-axis in the editor, *Lens* supports *left* and *right* axes. Each axis can have a different scale.

For each y-axis in the editor

It does not sound not to immediate to me exactly what it meant.

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

dej611 · 2021-05-14T10:55:53Z

Integrated most of the feedback @KOTungseth . Maybe we can discuss offline these remaining point?

dej611 · 2021-05-26T12:55:22Z

@elasticmachine merge upstream

wylieconlon

LGTM! I read through the changes here and they look accurate and good to ship, I think the areas you've pushed back on in the comments are also more accurate as written here.

wylieconlon · 2021-05-28T21:36:36Z

docs/user/dashboard/lens.asciidoc

+
+[float]
+[[why-my-field-x-is-missing-from-the-fields-list]]
+===== Why is my field X missing from the fields list?


There are a few possible reasons for a field to be missing:

Full text

Geo (in all released versions)

Mapping is not supported by index patterns, like flattened or object

Also, sometimes user say "missing" when it's actually in the "empty" list. Would be nice to summarize all of these if it can be done concisely, but I don't think it's a blocker.

Makes sense. I'll merge this and revisit that particular section in a subsequent PR

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>

kibanamachine · 2021-05-31T16:18:25Z

💚 Backport successful

Status	Branch	Result
✅	7.x

This backport PR will be merged automatically after passing CI.

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com> Co-authored-by: Marco Liberati <dej611@users.noreply.github.com> Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

dej611 added 2 commits April 14, 2021 17:58

📝 Add more QA for Lens

138e63b

🔥 Remove duplicate

0b29dbf

dej611 added v8.0.0 Feature:Lens v7.13.0 documentation Team:Docs and removed documentation labels Apr 14, 2021

dej611 marked this pull request as ready for review April 21, 2021 12:36

dej611 added the release_note:skip Skip the PR/issue when compiling release notes label Apr 21, 2021

spalger added v7.14.0 and removed v7.13.0 labels Apr 21, 2021

dej611 requested a review from KOTungseth April 27, 2021 10:07

mbondyra reviewed Apr 27, 2021

View reviewed changes

docs/user/dashboard/lens.asciidoc Outdated Show resolved Hide resolved

mbondyra reviewed Apr 27, 2021

View reviewed changes

docs/user/dashboard/lens.asciidoc Outdated Show resolved Hide resolved

mbondyra reviewed Apr 27, 2021

View reviewed changes

docs/user/dashboard/lens.asciidoc Outdated Show resolved Hide resolved

mbondyra reviewed Apr 27, 2021

View reviewed changes

docs/user/dashboard/lens.asciidoc Outdated Show resolved Hide resolved

mbondyra reviewed Apr 27, 2021

View reviewed changes

dej611 and others added 5 commits April 27, 2021 15:36

Update docs/user/dashboard/lens.asciidoc

460489d

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com>

Update docs/user/dashboard/lens.asciidoc

971ea11

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com>

Update docs/user/dashboard/lens.asciidoc

f472ab2

Co-authored-by: Marta Bondyra <marta.bondyra@gmail.com>

📝 Fix few issues based on feedback + new faq

20470e8

📷 Add missing picture

c65265c

KOTungseth reviewed May 4, 2021

View reviewed changes

dej611 and others added 3 commits May 5, 2021 10:16

Update docs/user/dashboard/lens.asciidoc

876116e

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

691b061

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

7db8640

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

dej611 and others added 14 commits May 5, 2021 10:20

Update docs/user/dashboard/lens.asciidoc

2cbf9ef

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

0aa77f4

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

d80ef91

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

e4f9717

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

bf4db3d

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

634d6ce

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

062319d

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

444d2f7

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

c8d901e

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

36e0619

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

088a107

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/dashboard/lens.asciidoc

9c4f409

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

👌 Integrated feedback

5e4a260

👌 More feedback

8ad9cd4

Merge branch 'master' into fix/more-lens-faq

af21cc0

dej611 added the auto-backport Deprecated - use backport:version if exact versions are needed label May 28, 2021

wylieconlon approved these changes May 28, 2021

View reviewed changes

dej611 merged commit 6c879cc into elastic:master May 31, 2021

dej611 deleted the fix/more-lens-faq branch May 31, 2021 16:16

kibanamachine mentioned this pull request May 31, 2021

[7.x] [Lens] [Docs] Add more QA for Lens (#97142) #101015

Merged

dej611 mentioned this pull request May 31, 2021

Advanced Lens documentation #81780

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Lens] [Docs] Add more QA for Lens #97142

[Lens] [Docs] Add more QA for Lens #97142

dej611 commented Apr 14, 2021

elasticmachine commented Apr 21, 2021

mbondyra Apr 27, 2021

mbondyra Apr 27, 2021

dej611 Apr 27, 2021

mbondyra left a comment

KOTungseth May 4, 2021

KOTungseth May 4, 2021

dej611 May 5, 2021

KOTungseth May 4, 2021

KOTungseth May 4, 2021

dej611 May 5, 2021

KOTungseth May 12, 2021

KOTungseth May 4, 2021

dej611 May 6, 2021

dej611 commented May 14, 2021

dej611 commented May 26, 2021

wylieconlon left a comment

wylieconlon May 28, 2021

dej611 May 31, 2021

kibanamachine commented May 31, 2021

	Sorting dimensions in visualizations is unsupported in Lens for charts.
	Sorting chart dimensions is unsupported in Lens, but you can sort the dimensions for a single column in data tables.

	Sorting is possible in Lens datatables, but it is limited to a single column. Click on the column header to sort by the column and select the sorting criteria.
	To sort the dimension of a single column, click the column header, then select the sorting criteria you want to use.

	Note that if the dimension is used within the `Columns` (transposed) then all columns that belong to the same dimension will be sorted.
	If the dimension is used within the transposed `Columns`, then all columns that belong to the same dimension are sorted.

	Lens lets you pick, for each Y dimension, up to two distinct axis: left and right. Each axis can have a different scale.
	For each y-axis in the editor, Lens supports left and right axes. Each axis can have a different scale.

[Lens] [Docs] Add more QA for Lens #97142

[Lens] [Docs] Add more QA for Lens #97142

Conversation

dej611 commented Apr 14, 2021

Summary

Checklist

elasticmachine commented Apr 21, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mbondyra 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

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

dej611 commented May 14, 2021

dej611 commented May 26, 2021

wylieconlon left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kibanamachine commented May 31, 2021

💚 Backport successful