From dc193ac87b839e84460b4c3dfea4910f9154dff7 Mon Sep 17 00:00:00 2001 From: Frederick Muriuki Muriithi Date: Mon, 12 Feb 2024 17:32:03 +0300 Subject: New Issue: Fix opaque UI errors. --- issues/quality-control/Fix-opaque-errors.gmi | 34 +++++++++++++++++++++ .../opaque-standard-error-upload-error.png | Bin 0 -> 38179 bytes 2 files changed, 34 insertions(+) create mode 100644 issues/quality-control/Fix-opaque-errors.gmi create mode 100644 issues/quality-control/opaque-standard-error-upload-error.png diff --git a/issues/quality-control/Fix-opaque-errors.gmi b/issues/quality-control/Fix-opaque-errors.gmi new file mode 100644 index 0000000..ad0c21e --- /dev/null +++ b/issues/quality-control/Fix-opaque-errors.gmi @@ -0,0 +1,34 @@ +# Fix Opaque Errors + +## Tags + +* status: open +* assigned: fredm +* type: bug +* priority: high +* keywords: opaque errors, errors, UX, user experience + +## Description + +This issue is meant to deal with instances of opaque errors. I describe the concept of "opaque errors", as errors whose messages do not provide the user with enough information to help them fix issues on their own where possible. + +As an example, see "Standard-Error Files Upload - Opaque Error Message" below. + +Fixed issues are marked with [x], in progress, or partially fixed issue with [-] and issues that have not had any work done yet with [ ]. + +### [ ] Standard-Error Files Upload - Opaque Error Message + +Trying to upload standard error files, the user might be faced with an error such as: +=> ./opaque-standard-error-upload-error.png + +This error does not tell the user much that is helpful. It should be changed to something like: +> There were no annotation found for the dataset "Standard Error Dataset" under +> the "BXD mice group study for breast cancer Standard Error" that is linked to +> the "Affymetrix Clariom S Array Mouse" platform. +> +> Please verify you selected the correct platform, study and dataset for your +> standard-error file(s). + +The error message in the screenshot attached above is obvious when one +=> https://git.genenetwork.org/gn-uploader/tree/scripts/insert_data.py?id=a7410cb1c55f6a06606ab7dcdacd18b11c672632#n254-n257 looks at the code (lines 254 to 259) +but it does not help the user figure out what they did wrong. diff --git a/issues/quality-control/opaque-standard-error-upload-error.png b/issues/quality-control/opaque-standard-error-upload-error.png new file mode 100644 index 0000000..a701ab5 Binary files /dev/null and b/issues/quality-control/opaque-standard-error-upload-error.png differ -- cgit v1.2.3