Apply suggestions from code review

Co-authored-by: Pierre Sassoulas <pierre.sassoulas@gmail.com>

Author: Julfried

doc/whatsnew/fragments/10402.bugfix

@@ -1,3 +1,3 @@
-Fix double underscores rendering as bold in pyreverse Mermaid output.
+Fix double underscores erroneously rendering as bold in pyreverse's Mermaid output.
 
 Closes #10402

pylint/pyreverse/mermaidjs_printer.py

@@ -33,10 +33,7 @@ def _open_graph(self) -> None:
  self._inc_indent()
 
  def _escape_mermaid_text(self, text: str) -> str:
- """Escape text to prevent Mermaid from interpreting it as Markdown
- formatting.
- """
- # Escape characters that conflict with Markdown formatting
+ """Escape characters that conflict with Markdown formatting."""
  text = text.replace("__", r"\_\_") # Double underscore → escaped
  return text