search

cmu-delphi / www-covidcast

Front end for interactive visualizations powering the COVIDcast website.
https://delphi.cmu.edu/covidcast/
MIT License
13 stars 2 forks source link

Make data descriptions more discoverable #433

Closed capnrefsmmat closed 3 years ago

capnrefsmmat commented 4 years ago

Right now, a user browsing the map only sees the one sentence description of each data source that appears as the map title. They'd have to browse to "Data and methods" to find more detail, and then from their browse to the API documentation if they want technical details. This means people may misinterpret signals, or may not get the context -- e.g. they may think all our data is from public sources, that we're "just another map", that the symptom surveys are run by someone else, etc.

I think the map app itself should provide them a way to get a more detailed description of each signal, while they're looking at it.

User story

A user browses the map. Somewhere -- maybe next to the title, maybe next to the graphs -- is a little i button to get more information about the signal.

They click the button and up pops a modal (or a pane, or something) that looks like this:

Symptoms

Each day, Delphi surveys tens of thousands of Facebook users and asks them if they or anyone in their household are currently experiencing symptoms. Based on the survey results, we estimate the percentage of people with COVID-like symptoms. A person has "COVID-like" symptoms if they have a fever, along with either cough, shortness of breath, or difficulty breathing. While many other conditions can cause these symptoms, comparing the rates of COVID-like symptoms across the country can suggest where COVID is most active.

More information • Technical description • Download data [link to the exporter coming in #422]

We can write these descriptions very clearly to indicate which ones are exclusively ours, and we can use the links at the bottom to link to sources, blog posts, etc.

capnrefsmmat commented 4 years ago

I'll add that after this, I think the "Data and methods" page can instead

and it no longer needs to have the blurbs for each signal.

RoniRos commented 4 years ago

I enthusiastically agree. I might even go beyond the little "i" button with a more prominent and enticing button like "what is this?" or "about this indicator".

krivard commented 4 years ago

I like i. The longer the button text, the larger the button, and the more of the map it obscures, especially on mobile...

RoniRos commented 4 years ago

I see your point. Can we make the button text dependent on display type / screen size? People like my wife Ilana will not even see the 'i'. :-( But maybe we shouldn't try to cater to them.

sgratzl commented 3 years ago

from PR:

The doc is here, awaiting review by @zackchase, so some elements may yet change.

google doc: https://docs.google.com/document/d/1kDqRg8EaI4WQXMaUUbbCGPlsUqEql8kgXCNt6AvMA9I/edit?usp=sharing

add a PR https://github.com/cmu-delphi/www-covidcast/pull/449 which the current state as of now

adamperer commented 3 years ago

@sgratzl , the text was updated. Can you push these latest changes? https://docs.google.com/document/d/1kDqRg8EaI4WQXMaUUbbCGPlsUqEql8kgXCNt6AvMA9I/edit

sgratzl commented 3 years ago

@sgratzl , the text was updated. Can you push these latest changes? https://docs.google.com/document/d/1kDqRg8EaI4WQXMaUUbbCGPlsUqEql8kgXCNt6AvMA9I/edit

see https://github.com/cmu-delphi/www-covidcast/pull/462

adamperer commented 3 years ago

Sorry @sgratzl , they made a few more updates. Here are the changes tracked (in the last edit): https://docs.google.com/document/d/1kDqRg8EaI4WQXMaUUbbCGPlsUqEql8kgXCNt6AvMA9I/edit#heading=h.oxebzdy7nl8w

(It appears the link didn't take directly to the changes... click 'Last edit' to see what was changed.