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 ++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 issues/quality-control/Fix-opaque-errors.gmi

(limited to 'issues/quality-control/Fix-opaque-errors.gmi')

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.
-- 
cgit v1.2.3