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.

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

Review & Update the "Ursache 3, API 10" FAQ entry #3069

Closed
Ein-Tim opened this issue Aug 2, 2022 · 8 comments · Fixed by #3419
Closed

Review & Update the "Ursache 3, API 10" FAQ entry #3069

Ein-Tim opened this issue Aug 2, 2022 · 8 comments · Fixed by #3419
Assignees
Labels
bug Something isn't working faq mirrored-to-jira

Comments

@Ein-Tim
Copy link
Contributor

Ein-Tim commented Aug 2, 2022

Where to find the issue

Describe the issue

There are multiple issues with this FAQ entry, among others, some are:

  1. It is in the "Resolved" section although the issue still occurs
  2. The entry links to the GitHub Issue Google API Exception 10: Unable validate key file signature cwa-app-android#1962 which is quite old now. To get relevant information, one has to scroll to the newest comments.

Suggested change

  1. Change the section the entry is listed in
  2. Remove the GitHub link and give useful information on what to do if a user encounters the error

Additional information

Please also note @MikeMcC399's comment corona-warn-app/cwa-app-android#1962 (comment) for further details.


Internal Tracking ID: EXPOSUREAPP-14130

@MikeMcC399
Copy link
Contributor

MikeMcC399 commented Aug 2, 2022

@Ein-Tim

Thanks for opening the issue. You wrote "Ursache 10" in your OP title, but it's actually "Ursache 3, API 10". (fixed)

In the FAQs themselves, there is a mismatch between the FAQ titles:

The English FAQ title is much shorter. It is missing the "CAUSE 3" part.

Also, I'm not sure whether the error message in German is the current one "URSACHE 3 – Etwas ist schiefgelaufen. Fehler bei Kommunikation mit Google API(10)" since the only similar text in the source code says "Fehler bei der Kommunikation mit der Google Schnittstelle" (or in English "Error during communication with Google interface").

We would probably need some support from the developers for this one, since I don't know how to simulate this error to check the exact text of the error message.

@Ein-Tim Ein-Tim changed the title Review & Update the "Ursache 10" FAQ entry Review & Update the "Ursache 3, API 10" FAQ entry Aug 2, 2022
@dsarkar dsarkar added the faq label Oct 13, 2022
@dsarkar dsarkar self-assigned this Oct 13, 2022
@Ein-Tim
Copy link
Contributor Author

Ein-Tim commented Feb 22, 2023

@MikeMcC399 What's your take on this issue, is it still relevant?

@MikeMcC399
Copy link
Contributor

@Ein-Tim

What's your take on this issue, is it still relevant?

So long as the app is still in use, this issue should be addressed. It would need developer help, so perhaps you could ask them if they are willing to pick it up?

@Ein-Tim
Copy link
Contributor Author

Ein-Tim commented Feb 22, 2023

@MikeMcC399

Thank you, I will keep this in my mind and think about how to continue here.

@brianebeling
Copy link
Member

brianebeling commented Feb 27, 2023

I will ask the devs how prevelant the issue still is and what the exact error message is. My personal take is that this issue is likely casued by an external factor (not the app itself) and as such is likely to remain - but changing the FAQ article to include the very detailed error description is confusing to the normal user. They would be better off seeing "error 10, that is what I have" and to then reach out to us via GitHub or preferably follow a simple set of instructions, like: Reset the google play services using the following tutorial.

I agree that the linked issue is not necessarily up to date anymore. Instead of creating a new issue I'd propose simplifying the title to be more in line with the FAQ Entry and keeping the original title in the issue.

Unfortuately this whole issue is very daunting for the end-user because its so technical, but hopefully we can slightly lower the burden by providing up to date documentation. Luckily its very very rare.

Possible To Do (needs talk with devs)

  • Research if URSACHE 3 is still relevant and the current error message
  • Adjust title to match in both languages
  • Link to current documentation from Google Play Services

@ndegendogo
Copy link

@brianebeling sounds good - thank you!

@brianebeling
Copy link
Member

Quick update:

  • In English it'd be "REASON 3" for German "URSACHE 3"
  • FAQ will be slightly adjusted to be more fitting
  • Issue is not really prevalent anymore, updating the title of the issue is fine
  • Linking to help article from google should help with basic troubleshooting

@Ein-Tim
Copy link
Contributor Author

Ein-Tim commented Feb 27, 2023

@brianebeling

That sounds like a good plan, thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working faq mirrored-to-jira
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants