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

Better setup wizard errors #11655

Conversation

rtibbles
Copy link
Member

Summary

  • Does some cleanup of vue prop warnings
  • Cleans up some form warnings
  • Reverts my previous suggestion to @akolson to use UIAlert, as it causes a big old mess without additional strings, and reverts to the AppError component
  • Always displays a retry and a restart button if there is an error on the provisioning page to ensure that people can start over if needed.

References

Fixes #11574

image

Reviewer guidance

I tested this by adding raise Exception here: https://github.com/learningequality/kolibri/blob/release-v0.16.x/kolibri/core/device/api.py#L101


Testing checklist

  • Contributor has fully tested the PR manually
  • If there are any front-end changes, before/after screenshots are included
  • Critical user journeys are covered by Gherkin stories
  • Critical and brittle code paths are covered by unit tests

PR process

  • PR has the correct target branch and milestone
  • PR has 'needs review' or 'work-in-progress' label
  • If PR is ready for review, a reviewer has been added. (Don't use 'Assignees')
  • If this is an important user-facing change, PR or related issue has a 'changelog' label
  • If this includes an internal dependency change, a link to the diff is provided

Reviewer checklist

  • Automated test coverage is satisfactory
  • PR is fully functional
  • PR has been tested for accessibility regressions
  • External dependency files were updated if necessary (yarn and pip)
  • Documentation is updated
  • Contributor is in AUTHORS.md

@rtibbles rtibbles added the TODO: needs review Waiting for review label Dec 15, 2023
@github-actions github-actions bot added APP: Setup Wizard Re: Setup Wizard (facility import, superuser creation, settings, etc.) DEV: frontend SIZE: small labels Dec 15, 2023
@@ -166,7 +163,7 @@
return this.wizardContext('onMyOwnOrGroup') == UsePresets.ON_MY_OWN;
},
},
mounted() {
created() {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Curious why the change from mounted -> created?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Do you need to access the DOM? If no, don't use mounted." - past Richard (to me)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well from the look of it, we are not manipulating the DOM(at least not directly) so it justifies the change.

@marcellamaki marcellamaki self-assigned this Dec 19, 2023
Copy link
Member

@akolson akolson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look correct to me. With additional manual QA, we should be good to go! Thanks @rtibbles!

Copy link
Member

@nucleogenesis nucleogenesis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall this LGTM!

Comment on lines +16 to +17
<KButtonGroup>
<slot name="buttons">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice <3

@marcellamaki
Copy link
Member

@radinamatic - could we get some manual QA here? One use case to test Radina was the issue you reported some time ago with running into issues with Android "On My Own" setup with earlier android devices. Testing on this would be helpful because it would be two for the price of one - seeing if the updates here are working, and it would give us more useful error messages for that problem to see if we can continue to make some progress on it, since I've been a bit blocked in being able to figure out what's wrong. Thank you!

Copy link
Member

@marcellamaki marcellamaki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requesting changes just to block for merge until manual QA happens. Noting that I have not done code review here and have deferred to @akolson and @nucleogenesis on this one, but I would be happy to review the code if needed.

@pcenov pcenov self-requested a review January 3, 2024 15:55
Copy link
Member

@pcenov pcenov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @rtibbles, unfortunately now the error page gets briefly displayed in all setup flows just after having successfully completed the setup process. It won't let me click on Help us by reporting this error. Here's an example for On my own:

2024-01-04_16-24-21.mp4

The same is also happening in the Android app:

2024-01-04_16-01-02.mp4

Otherwise I can confirm that in a scenario where there is an actual error it's now being handled gracefully:

2024-01-04_16-29-41.mp4

Logs:
UbuntuLogs.zip

AndroidOnMyOwnLogs.zip

@rtibbles
Copy link
Member Author

rtibbles commented Jan 4, 2024

Thanks @pcenov a simple oversight on my part to not conditionalize the display of the error - should be fixed now.

@pcenov pcenov self-requested a review January 5, 2024 12:30
Copy link
Member

@pcenov pcenov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implemented as specified above, no regression issues observed - good to go!

@marcellamaki marcellamaki dismissed their stale review January 5, 2024 19:19

dismissing as only blocker was manual QA approval

@marcellamaki marcellamaki merged commit dfe1a9d into learningequality:release-v0.16.x Jan 5, 2024
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
APP: Setup Wizard Re: Setup Wizard (facility import, superuser creation, settings, etc.) DEV: frontend SIZE: small TODO: needs review Waiting for review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve error management and allow the user to retry and report errors during "Setting Up Kolibri"
5 participants