Support users to submit their first experience

[GeorgiaHCA]

Summary

There is evidence from previous focus groups that the research question is quite broad and it may be unclear or ambiguous to new users what to enter and how to enter it. It would be helpful to have a walkthrough, tutorial or other method to support people to enter stories - create an AutSPACEs onboarding process.

Deadline

What needs to be done?

• Look at existing citizen science projects and how they onboard people
• Research into what is possible
• Create a diagram or diagrams to support onboarding

Who can help?

• Please add any suggestions or feedback in the comments below.

---

Updates

[gedankenstuecke]

Here's a few JS walkthrough libraries:

• IntroJS
• ShepherdJS
• TourGuide

Having said that, I don't have 1st-hand experience with either of them!

[GeorgiaHCA]

I've made a basic flow chart diagram using draw.io - would it be helpful to include screenshots?

[gedankenstuecke]

Do you mean including screenshots of the flowcharts here? Or including screenshots in the flowcharts?

Oh, and the draw.io link requires permission to view!

[GeorgiaHCA]

I was meaning that it could be helpful to users to have screenshots of the platform alongside the steps in the flowchart, maybe with arrows or elements highlighted? Here's another link to the flowchart: https://drive.google.com/file/d/1J3zaYyY01WCvc0On6Q2LxAB7xvq2o4UU/view?usp=sharing

[gedankenstuecke]

thanks, the link now works! I wouldn't add screenshots into the flowchart, as I think the point would be to have a quicker overview of the process and adding screenshots could expand on that too much?

[GeorgiaHCA]

Hi @llewelld - I think a couple of sentences would be enough for now in the Help section. Maybe something like:

To share an experience on AutSPACEs, please go to the share experience page when you are logged in and write n the text box about any time you have been effected by your senses. Then you can submit your experience for research or to share publicly on our website. The flow chart below shows the steps you can take to share an experience on AutSPACEs.

How does that sound @llewelld, @gedankenstuecke ?

[gedankenstuecke]

Yes, that sounds good! Can also link the 'share experience' page from the text :)

[llewelld]

Thanks for the text and suggestion; that's great! This PR shows what it looks like with this added in: #561

[llewelld]

Here's a few JS walkthrough libraries:

• IntroJS
• ShepherdJS
• TourGuide

Examples of usage for Shepherd.js and TourGuide can be found in #564 and #575 respectively.

I had a quick look at IntroJS but this has a GNU AGPLv3 licence which will conflict with our MIT licence, so I didn't look into that further.

[gedankenstuecke]

Based on the feedback of the September 2023 user testing, it seems like this might be a feature some people would use, but generally not too many people wanted/seemed to need a tour as improvements could be made through clearer signposting of existing pages. Should we shelve this for now?

[gedankenstuecke]

Given the updates to usability so far I will close this as stale/outdated or now.

If the second round of user testing uncovers that this remains an open need we can pick up the two PRs that @llewelld made and that are still open as drafts