tests - clarify comment in test files

Author: cderv

tests/docs/smoke-all/jupyter/error/display-error-false.qmd

@@ -20,13 +20,12 @@ class BuggyDisplay:
         self.data = "This works fine"
     
     def _repr_html_(self):
-        # This error happens during display, not execution
-        # raise ValueError("Display phase error!")
+        # HTML representation used for `format: html`
         return "<b>HTML fallback:</b> " + self.data
 
     def _repr_markdown_(self):
-        # Markdown representation as fallback when HTML fails
-        # return "**Markdown fallback:** " + self.data
+        # This error happens during display, not execution
+        # even if the markdown reprensentation is not used
         raise ValueError("Display phase error!")
     
     def __repr__(self):

tests/docs/smoke-all/jupyter/error/display-error-true-global.qmd

@@ -22,11 +22,12 @@ class BuggyDisplay:
         self.data = "This works fine"
     
     def _repr_html_(self):
-        # This error happens during display, not execution
+        # HTML representation used for `format: html`
         return "<b>HTML fallback:</b> " + self.data
 
     def _repr_markdown_(self):
-        # Markdown representation as fallback when HTML fails
+        # This error happens during display, not execution
+        # even if the markdown reprensentation is not used
         raise ValueError("Display phase error for Markdown!")
     
     def __repr__(self):