Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update the Android FAQ #75

Closed
1 of 3 tasks
seanlip opened this issue Apr 14, 2023 · 30 comments
Closed
1 of 3 tasks

Update the Android FAQ #75

seanlip opened this issue Apr 14, 2023 · 30 comments
Assignees
@jlevick

Comments

@seanlip
Copy link
Member

seanlip commented Apr 14, 2023 •
edited
Loading

Platform
Oppia Android

Describe the request

Per this comment, we should take a look at our FAQ and ensure that it is what we want to present to users.

The aim of this issue is to audit the FAQ in the Android app and propose any changes that need to be made. We have not yet seen evidence that users use the FAQ, but in case they do, we would like to provide a structured experience that is structured coherently, answers their questions properly and is not misleading (e.g. details features that are not present within the app). Some additional questions that might be nice to answer include:

  • Why are there only math lessons?
  • Will you be making more lessons?
  • I found a bug. How can I report it?
  • How do I get the app in my language?
  • How do I update the app?
  • How do I update my Android OS? (see Android App Deprecation notification feature #62)

and possibly others.

Context for the request

This is an audit of an existing feature (the FAQ in the Android app).

Link to PRD
N/A

Information about deadlines/priorities
This can be tackled at the usual priority.

DESIGN APPROVAL CHECKLIST -- DO NOT EDIT.

  • UX Design approved (Android mocks should include dark mode)
  • UX Writing approved
  • Product approved

For a design project to be completed, it needs approval from UXD, UXW and PM. Please tag the following reviewers when your project is ready (it's enough to have one signoff from each of UXD, UXW and PM):
@seanlip
Copy link
Member Author

seanlip commented Apr 14, 2023

Assigning to @danapj since this is mainly a UXW project.

@seanlip seanlip mentioned this issue Apr 14, 2023
Closed
@danapj danapj moved this from Not Started to In Progress in UX Design + UX Writing Projects Board Apr 22, 2023
@danapj danapj assigned jlevick and unassigned danapj May 23, 2023
@danapj
Copy link

danapj commented May 23, 2023 •
edited
Loading

@jlevick let me know if you would like this as a side project, and if you have an Android phone! This project might be easier if you can use the app

@danapj danapj self-assigned this May 23, 2023
@jlevick
Copy link

jlevick commented May 23, 2023

@danapj I unfortunately don't have an Android phone, but if you think I can work on this without one I'll definitely take it as a side project!

@danapj
Copy link

danapj commented May 28, 2023

@jlevick how would you like to work on this one together on the side? :D since it'll affect both our projects too! I have an Android phone so I could help with that side of things

@seanlip seanlip moved this from In Progress to Not Started in UX Design + UX Writing Projects Board Jun 8, 2023
@seanlip seanlip moved this from Not Started to In Progress in UX Design + UX Writing Projects Board Jun 8, 2023
@seanlip
Copy link
Member Author

seanlip commented Jun 9, 2023

Just a note -- we might want to consider doing this a bit quicker. The current FAQ in the app is wrong, it has things like: "If changing your phone number: Enter your new phone number and tap Verify. A code is sent to confirm your new number. The code will expire after 5 minutes and must be entered in the new screen to be associated with your account." -- but we don't actually have that functionality in the app.

That said, not many users read the FAQ anyway. So there's an open question here about whether we want to actively try and make it more helpful, or keep this low-priority since it's not used that much. What do you all think?

@kaiyuxu
Copy link

kaiyuxu commented Jun 9, 2023

I would focus on the core flows/ projects and make this lower priority... sounds like bug reporting can be part of the feedback flow. Will the first two questions on lessons be answered in the onboarding flow?

@seanlip
Copy link
Member Author

seanlip commented Jun 9, 2023 •
edited
Loading

Will the first two questions on lessons be answered in the onboarding flow?

I'm not sure, but I don't think so -- though @tanzhirong (the PM) and @juliafalarini (the designer) would know better :)

@tanzhirong
Copy link

@seanlip Are the first 2 questions "Why are there only math lessons? Will you be making more lessons"? If so, correct, these are not addressed in the onboarding flow.

@seanlip
Copy link
Member Author

seanlip commented Jun 9, 2023 •
edited
Loading

Yup that's right, those are the first two questions. Thanks for confirming, @tanzhirong!

@danapj
Copy link

danapj commented Jul 26, 2023

we'll be picking this up again sorry for the delay!

@jlevick
Copy link

jlevick commented Sep 16, 2023

Hi @seanlip, I'm not sure what the answers are to these Qs for the FAQ...is there somewhere I can find info around the answers, and then I can rewrite them to be more concise, clear, etc.? I've listed the ones I'm most unsure about below. Also unsure where to provide the answers to the Qs once they're written...would I just put them in another comment on this ticket? Thank you!

  • Why are there only math lessons?

  • I found a bug. How can I report it? - Would this be the feedback feature in the app?

  • How do I get the app in my language? - I know it's currently available in English and Brazilian Portuguese, but unsure what the answer might be?

  • How do I update the app?

@seanlip
Copy link
Member Author

seanlip commented Sep 16, 2023

Hi @jlevick, here are some (very unedited) notes on the answers! I think you can just add the desired ones in another comment on this ticket, yup.

  • Why are there only math lessons? This is because our mission is to help learners gain key skills that they need in life, and numeracy / basic math is a fundamental skill, so we started there. We are however planning to introduce new lessons soon on Science and other subjects, so check back regularly!
  • I found a bug. How can I report it? - Would this be the feedback feature in the app? Yep, see https://github.com/orgs/oppia/projects/7/views/9?pane=issue&itemId=18747855
  • How do I get the app in my language? The app currently supports English, Brazilian Portuguese, Arabic and Nigerian Pidgin. The language list can be accessed using the side menu (I think it's through Settings?) We are interested in providing more languages, please contact XXX email address if you'd like to request that the app be available in your language.
  • How do I update the app? Go to the Play Store and do that, just like any other app (we probably want to provide clearer instructions).

@jlevick
Copy link

jlevick commented Sep 28, 2023 •
edited
Loading

Thank you @seanlip! Here is what I have, please let me know if you think anything needs editing. I don't have an Android phone, but Kate sent me her Figma file, so I think these make sense.

- Why are there only math lessons?
Oppia’s mission is to help learners gain necessary life skills. Math is an essential skill in everyday life. Oppia will be offering new lessons on science and other subjects soon!

- Will you be making more lessons?
Yes, Oppia will be offering new lessons on science and other subjects soon. Please check back for updates!

- I found a bug. How can I report it?

  1. From your Oppia app home screen, tap the menu in the top left corner.
  2. Tap Share feedback.
  3. Follow the instructions to report the bug or to share any feedback.

- How do I get the app in my language?
The Oppia app currently supports English, Brazilian Portuguese, Arabic, and Nigerian Pidgin. Choose one of these languages in the menu, under Options. To request the app in your language, please contact email address.

- How do I update the app?

  1. Open the Google Play Store app.
  2. Tap the profile icon in the top right corner.
  3. Tap Manage apps and device.
  4. Locate the Oppia app.
  5. Tap Update.

I have not yet worked on the last question listed, How do I update my Android OS? Also, github is changing my numbers into roman numerals, but for the devs: we would like numbers (1, 2, 3 etc). Thanks!

@kmuir1991
Copy link

kmuir1991 commented Sep 28, 2023 via email

@jlevick
Copy link

jlevick commented Sep 29, 2023

@kmuir1991 oops! Thank you for pointing that out! I'll edit it above :)

@seanlip
Copy link
Member Author

seanlip commented Sep 29, 2023

Thanks! Took a look, and the only question I have is about "How do I update the app?". The flow suggested takes me to a page where the only thing I can do is delete it :)

Maybe better to go to Play Store, search for the app and click Update?

@jlevick
Copy link

jlevick commented Sep 30, 2023 •
edited
Loading

@seanlip ha! That is certainly not what we want! It's been updated here :) I've also included copy for the last remaining FAQ question, How do I update my Android OS? Please let me know if you see anything else that needs to be corrected. Thanks!

  • Why are there only math lessons?
    Oppia’s mission is to help learners gain necessary life skills. Math is an essential skill in everyday life. Oppia will be offering new lessons on science and other subjects soon!

  • Will you be making more lessons?
    Yes, Oppia will be offering new lessons on science and other subjects soon. Please check back for updates!

  • I found a bug. How can I report it?

  1. From your Oppia app home screen, tap the menu in the top left corner.
  2. Tap Share feedback.
  3. Follow the instructions to report the bug or share feedback.

  • How do I get the app in my language?
    The Oppia app currently supports English, Brazilian Portuguese, Arabic, and Nigerian Pidgin. Choose one of these languages in the menu, under Options. To request the app in your language, please contact us at email address.

  • How do I update the app?

  1. Open the Google Play Store app.
  2. Search for the Oppia app.
  3. Tap Update.
  • How do I update my Android OS?
  1. Tap your phone's Settings app.
  2. Tap System updates.
  3. Tap System updates and follow the instructions to update your Android operating system.

Github is changing these numbers into roman numerals, but for the devs: we would like numbers (1, 2, 3 etc). Thanks!

@seanlip
Copy link
Member Author

seanlip commented Oct 3, 2023

Thanks @jlevick! It looks pretty good, just two comments:

  • I think, for the last question, the option is "System updates" on my phone, not "Systems updates". Is it "Systems updates" on yours? If so then we might need to make this more general, but I'm not sure.
  • There are more questions in the current FAQ than just these. If we update the app to include the new questions and responses, what should the new order be for all the questions? Also, do you think the title "Featured Questions" in the app is correct?

@jlevick
Copy link

jlevick commented Oct 5, 2023

Hi @seanlip, I don't have an Android phone. I'll edit it above to say "system" vs. "systems" :)
In regard to the title "Featured Questions", I think featured seems misleading as there are no other FAQs that are not featured. Perhaps "Common questions" would be more appropriate? Or even "Frequent questions" (would love your opinion if you have time, @kmuir1991 :)

@kmuir1991, do you know if the following are the only FAQs in the app as of now? I found them in the IA Figma file:

  • How can I create a new profile?
  • How can I delete a profile?
  • How can I change my email/phone number?
  • What is Oppia?
  • Who is an Administrator?
  • Why is the Exploration player not loading?
  • Why is my audio not playing?
  • I can’t find my question here. What now?

Lastly, do either of you know if there is any research the UXR team has done on which questions are searched for most? I'm thinking perhaps not as this initial ticket states there's not much evidence that folks are using the FAQ. I'll play around with the order of all Qs once I know if these (and the ones I wrote for) are all there are. Thanks!

@seanlip
Copy link
Member Author

seanlip commented Oct 5, 2023

@jlevick Yup, the questions you mention match what I see in my version of the app :)

And yeah, I'm pretty sure the UXR team hasn't done research on this, for the reason you mention.

@kmuir1991
Copy link

kmuir1991 commented Oct 6, 2023 via email

@seanlip
Copy link
Member Author

seanlip commented Oct 6, 2023

No concerns re the above. (Re the last question, see my previous note in this thread.)

@jlevick
Copy link

jlevick commented Oct 16, 2023

@seanlip @kmuir1991 @roxanashirazi does anyone know why the current Qs are in the order they are?
Thanks!

@seanlip
Copy link
Member Author

seanlip commented Oct 17, 2023 •
edited
Loading

There isn't a good reason. Feel free to reorder/reorganize/add/delete as you see fit. Thanks!

@jlevick
Copy link

jlevick commented Oct 17, 2023

Thanks @seanlip and @kmuir1991!
Here is the order I think makes the most sense.

  • What is Oppia?
  • Who is an Administrator?
  • How can I create a new profile?
  • How do I get the app in my language?
  • I found a bug. How can I report it?
  • Why are there only math lessons?
  • Will you be making more lessons?
  • Why is the Exploration player not loading?
  • Why is my audio not playing?
  • How can I delete a profile?
  • How can I change my email/phone number?
  • How do I update the app?
  • How do I update my Android OS?
  • I can’t find my question here. What now?

@kmuir1991
Copy link

kmuir1991 commented Oct 17, 2023 via email

@seanlip
Copy link
Member Author

seanlip commented Oct 18, 2023

Thanks @jlevick!

Just to check, do you want to make any changes to the answers to the existing questions? If not, I think this is probably enough info to send to the developer team...

@jlevick
Copy link

jlevick commented Oct 18, 2023

I think the Q How can I create a new profile? should be slightly updated, below is the current copy and updated suggestion:

Current
If it is your first time creating a profile and not have a PIN:

Updated:
If it is your first time creating a profile and you do not have a PIN:

Otherwise I think it's fine! @seanlip

@seanlip seanlip moved this from In Progress to Handed off to PM in UX Design + UX Writing Projects Board Oct 18, 2023
@seanlip
Copy link
Member Author

seanlip commented Oct 18, 2023 •
edited
Loading

Great, thanks! Moving this to the "handed off to PM" section, I'll get it filed when I'm back from travels.

@seanlip seanlip mentioned this issue Nov 25, 2023
Closed
@seanlip
Copy link
Member Author

seanlip commented Nov 25, 2023

Filed as oppia/oppia-android#5246. Thanks @jlevick and sorry for the delay on this!

@seanlip seanlip closed this as completed Nov 25, 2023
@github-project-automation github-project-automation bot moved this from Handed off to PM to Completed in UX Design + UX Writing Projects Board Nov 25, 2023
@Rd4dev Rd4dev mentioned this issue Feb 4, 2024
Merged
6 tasks
adhiamboperes added a commit to oppia/oppia-android that referenced this issue Feb 14, 2024
@Rd4dev @adhiamboperes
Fix #4527: FAQ Inappropriate faqs removed (#5332)
30ba44d 
<!-- READ ME FIRST: Please fill in the explanation section below and
check off every point from the Essential Checklist! -->
## Explanation
<!--
- Explain what your PR does. If this PR fixes an existing bug, please
include
- "Fixes #bugnum:" in the explanation so that GitHub can auto-close the
issue
  - when this PR is merged.
  -->

Fixes #4527

The [design team](oppia/design-team#75) and
the previous [PRs](#5247)
addressed various issues and revised the FAQ list. However, @seanlip
pointed out in the
[discussions](oppia/design-team#75 (comment))
that the FAQ related to updating mobile numbers or email addresses
appears inappropriate.

After verifying with @adhiamboperes and @BenHenning, the initial commit
includes removing [that specific
FAQ](https://github.com/oppia/oppia-android/blob/3ced7e14a8bff8c3757ed15a1626b0e63c6ce14d/app/src/main/res/values/strings.xml#L574)

## Essential Checklist
<!-- Please tick the relevant boxes by putting an "x" in them. -->
- [x] The PR title and explanation each start with "Fix #bugnum: " (If
this PR fixes part of an issue, prefix the title with "Fix part of
#bugnum: ...".)
- [x] Any changes to
[scripts/assets](https://github.com/oppia/oppia-android/tree/develop/scripts/assets)
files have their rationale included in the PR explanation.
- [x] The PR follows the [style
guide](https://github.com/oppia/oppia-android/wiki/Coding-style-guide).
- [x] The PR does not contain any unnecessary code changes from Android
Studio
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#undo-unnecessary-changes)).
- [x] The PR is made from a branch that's **not** called "develop" and
is up-to-date with "develop".
- [x] The PR is **assigned** to the appropriate reviewers
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#clarification-regarding-assignees-and-reviewers-section)).

---------

Co-authored-by: Adhiambo Peres <59600948+adhiamboperes@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@jlevick jlevick

Labels
None yet
Projects
UX Design + UX Writing Projects Board
Archived in project
Milestone
No milestone
Development

No branches or pull requests
7 participants
@seanlip @tanzhirong @kaiyuxu @danapj @kmuir1991 @jlevick @stepmalt