Suggestion for error handling / Help documentation

I have a request that I believe would tremendously help new and experienced users of Qubes alike.

When the system encounters an error and throws an error message popup or a system notification, it would be extremely helpful if the resultant error codes and associated filenames were hyperlinked to relevant Qubes man/wiki pages - with the additional option of having the problematic files hyperlinked to their relevant config files.

It would place Qubes light years ahead when it came to trouble-shooting Qubes errors and considerably ease the Qubes learning curve.

I’m not sure to understand your idea. Could you provide an example?

I’ve taken a snippet of a Qubes error from an Internet page and highlighted 2 areas of one file’s errors for hyperlinks:

Clicking on devicetree.py would open the /usr/lib/python3.5/site-packages/blivet/devicetree.py file to line 184.

Clicking on ā€œDevice ā€˜%s’ not in treeā€ % dev.name would link to man/wiki pages with additional information on that specific error.

The same would apply to the other file errors.
I would be interested to hear your thoughts.

1 Like

Unfortunately, that kind of error message is a Python traceback: the program is falling in some unexpected way, so there is no related manpage or documentation page. A link to the specific file might not help either.

1 Like

If the ā€œlink to the specific file might not help eitherā€, then what purpose is served by including it - along with a line number - in the error message? Doing so would only seem to make the error more difficult to solve as it leads one to believe there is some sort of a discrepancy in the file at that line number.
It is the ā€œDevice ā€˜%s’ not in treeā€ % dev.name link that would direct to the corresponding man/wiki page.
If a link to the file doesn’t help, and a link to the error description doesn’t help, then doesn’t showing messages with this type of information only add to the confusion and difficulty of solving whatever error has occurred?

1 Like

This message comes from the Python programming language. It should not be displayed to the user, but to the developers.

It should be reported as a bug, like this:

1 Like

Thanks, but you’re missing my point.
I obviously used a bad example.
My suggestion was meant to refer to error messages that display to the user where he/she is expected to troubleshoot/repair the issue themselves.

1 Like