wordpress-mobile / wordpress-mobile/WordPress-Android

Quick Start Tour Tweaks

Open
#15,258 11 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

[Type] Enhancement /My site My Site Dashboard Quick Start
Dominant language
Kotlin
Stars
3.2k
Forks
1.4k
Avg merge
1d 11h
Merged PRs (30d)
69

Description

Context
  • In the My Site Dashboard project we have converted the existing Quick Start entry point into a dashboard card.
  • As we are moving other pieces to the new My Site Fragment/Screen, we noticed some of the tour guide text was not using the native Snackbar component.
  • We've moved the custom tour steps to the native Snackbar components.
  • There are some gaps and discrepancies which we want to tidy up.
Issues Found

Text Styes:

  • In the one line Snackbars, normal text is regular weight, grey color. Emphasised text is regular weight, white colour. This is fine. Can stay.
  • In the prompts which we have changed. Most text is regular weight, grey color. Emphasised text is bold weight, grey color. Can we change the emphasised text to bold weight, white color. This should match the emphasis we had before the change.
  • If having emphasis change both colour and font-weight is not possible in the component, we can look at a different solution.

Dead pixels above Snackbar

  • Above some of the Snackbars there is an area where the UI is cut-off/hidden
  • It might be to do with the way the shadow or padding around the Snackbar is rendered
  • I have seen this issue before so it might be pre-existing
  • See image below, the 'Stats' list item is being partly cut-off
    cut off area

Area hidden after Snackbar dismisses

  • After the Snackbar has been dismissed, I noticed a couple of times the visual area where it had been is still hidden
  • Might be related to the above issue
    Screenshot_2021-08-31-09-31-26-695_org wordpress android prealpha

Delayed Snackbars

  • On some of the steps in the tour, it told me to take an action
  • When I tapped 'Go', it scrolled me to the relevant location and showed the blue dot with the touch target
  • The Snackbar didn't display immediately. I could only see the blue dot. Sometimes the Snackbar appeared after I'd even tapped the dot, so it felt a bit glitchy.
  • This happened on the steps for: View Site, Create post, Search Reader, Check Stats

Snackbars disappear quite quickly

  • Sometimes the next prompt disappeared before I had read it
  • Previously, did it auto-dismiss? I think you said it did, but maybe had a longer duration?
  • I would err on the side of longer duration

End of tour

  • When the tour ends, there's a notification in the notifications tab
  • There's no success indication in the My Site UI. Was this the case before?
  • The Quick Start card disappears immediately. Was this the same as before? I'd be tempted to show it completed after the last step, then dismiss it after 1 day or similar afterwards.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Quick Start tour and its native Snackbar components, reproducing the steps for View Site, Create post, Search Reader, and Check Stats. Compare the emphasis styling, clipping, dismissal, timing, and end-of-tour behavior against the reported screenshots; done means the listed tour prompts display consistently and the Quick Start flow completes without the reported glitches.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
mobile
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.