magda-io / magda

A federated, open-source data catalog for all your big data and small data
https://magda.io
Apache License 2.0
507 stars 92 forks source link

Better explain data quality in tooltip #1181

Open stephencannings opened 6 years ago

stephencannings commented 6 years ago

Problem description

users think stars are 'customer review' related, The tooltip pop up directs users to another page in order to understand the stars.

Goal it to provide enough contextual info to not require most users to go elsewhere.

Problem reproduction steps

N/A

Screenshot / Design / File reference

image

stephencannings commented 6 years ago

[admin note - I need to have my perms adjusted to I can assign to self]

stephencannings commented 6 years ago

TEXT FOR POP UP

Calculated on online availability, machine readability, open formats, use of references and contextual information. More on the [open data scale].

azerella commented 6 years ago

@stephencannings I did a quick mock up on how this text would look on the tooltip:

screen shot 2018-06-19 at 10 53 15 am

If you think it looks good we can make a PR with the changes 😄 .

stephencannings commented 6 years ago

Hi Matt,

Thanks, I think that should work, gives enough information without needing to go to an info page.

Make it so :)

Stephen

On Tue, 19 Jun 2018 at 10:54, Adam A. Zerella notifications@github.com wrote:

@stephencannings https://github.com/stephencannings I did a quick mock up on how this text would look on the tooltip:

[image: screen shot 2018-06-19 at 10 53 15 am] https://user-images.githubusercontent.com/1501560/41569655-1273cdfe-73af-11e8-9fa3-c5ce6446b984.png

If you think it looks good we can make a PR with the changes 😄 .

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/TerriaJS/magda/issues/1181#issuecomment-398240321, or mute the thread https://github.com/notifications/unsubscribe-auth/AliH5mWoH61_ocNiC4Smt21GsZf679qbks5t-EvfgaJpZM4Ub8_b .

-- Stephen Cannings Content designer - data.gov.au http://data.gov.au Digital Transformation Agency (DTA)

Australian Government www.dta.gov.au http://www.dto.gov.au/

tkeuneman commented 6 years ago

@stephencannings @adamzerella The text for this tooltip is now a paragraph, which is too big for the purpose of a tooltip i.e. something that briefly explains what you are looking at. Can you make it more brief? That is, either pick one or two things to mention or keep as is.

stephencannings commented 6 years ago

@tash.keuneman@data61.csiro.au tash.keuneman@data61.csiro.au @Adam Zerella adam.zerella@digital.gov.au

I think of it functioning more like a pop-up (or popover) and not a tooltip.

Currently, it requires the user to exit the page to have any understanding of what the star ratings actually mean. So it's a problematic tooltip :)

But I digress. Chunky it is .... let's perhaps try:

Calculated on criteria such as machine readability, open formats and more. See [open data scale].

S.

On Tue, 19 Jun 2018 at 17:21, Tash Keuneman notifications@github.com wrote:

@stephencannings https://github.com/stephencannings @adamzerella https://github.com/adamzerella The text for this tooltip is now a paragraph, which is too big for the purpose of a tooltip i.e. something that briefly explains what you are looking at. Can you make it more brief? That is, either pick one or two things to mention or keep as is.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/TerriaJS/magda/issues/1181#issuecomment-398300474, or mute the thread https://github.com/notifications/unsubscribe-auth/AliH5tGhC1XT4uiU32HDZWwCJfmPhKcUks5t-KaVgaJpZM4Ub8_b .

-- Stephen Cannings Content designer - data.gov.au http://data.gov.au Digital Transformation Agency (DTA)

Australian Government www.dta.gov.au http://www.dto.gov.au/

stephencannings commented 6 years ago

or, as to lead into the nice article..:

How we calculate [open data quality].

or less personal as we don't manually calculate

How is [open data quality] rated?

tkeuneman commented 6 years ago

References from other ticket: https://www.appcues.com/blog/tooltips http://idratherbewriting.com/2010/08/13/best-practices-for-writing-interface-text-organizing-content-24/ https://docs.microsoft.com/en-us/windows/desktop/uxguide/ctrl-tooltips-and-infotips

stephencannings commented 6 years ago

Good reads.