summaryrefslogtreecommitdiff
path: root/issues/quality-control
diff options
context:
space:
mode:
authorFrederick Muriuki Muriithi2024-02-12 17:32:03 +0300
committerFrederick Muriuki Muriithi2024-02-12 17:32:03 +0300
commitdc193ac87b839e84460b4c3dfea4910f9154dff7 (patch)
treeadced207fba4205fda13f8a4f48451816a0acbff /issues/quality-control
parent73a1d086efe64c990eebd59f191955dd1ddb1af6 (diff)
downloadgn-gemtext-dc193ac87b839e84460b4c3dfea4910f9154dff7.tar.gz
New Issue: Fix opaque UI errors.
Diffstat (limited to 'issues/quality-control')
-rw-r--r--issues/quality-control/Fix-opaque-errors.gmi34
-rw-r--r--issues/quality-control/opaque-standard-error-upload-error.pngbin0 -> 38179 bytes
2 files changed, 34 insertions, 0 deletions
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
--- /dev/null
+++ b/issues/quality-control/opaque-standard-error-upload-error.png
Binary files differ