diff --git a/src/schemas/json/partial-pyright.json b/src/schemas/json/partial-pyright.json
index fcaf363b854..bd36fe03216 100644
--- a/src/schemas/json/partial-pyright.json
+++ b/src/schemas/json/partial-pyright.json
@@ -548,9 +548,9 @@
     "reportAssertAlwaysTrue": {
       "$ref": "#/definitions/diagnostic",
       "title": "Controls reporting `assert` expressions that will always evaluate to `True`",
-      "description": "Generate or suppress diagnostics for `assert` statement that will provably always assert. This can be indicative of a programming error.",
-      "markdownDescription": "Generate or suppress diagnostics for `assert` statement that will provably always assert. This can be indicative of a programming error.",
-      "x-intellij-html-description": "Generate or suppress diagnostics for <code>assert</code> statement that will provably always assert. This can be indicative of a programming error.",
+      "description": "Generate or suppress diagnostics for `assert` statement that will provably always assert because its first argument is a parenthesized tuple (for example, `assert (v > 0, \"Bad value\")` when the intent was probably `assert v > 0, \"Bad value\"`). This is a common programming error.",
+      "markdownDescription": "Generate or suppress diagnostics for `assert` statement that will provably always assert because its first argument is a parenthesized tuple (for example, `assert (v > 0, \"Bad value\")` when the intent was probably `assert v > 0, \"Bad value\"`). This is a common programming error.",
+      "x-intellij-html-description": "Generate or suppress diagnostics for <code>assert</code> statement that will provably always assert because its first argument is a parenthesized tuple (for example, <code>assert (v &gt; 0, &quot;Bad value&quot;)</code> when the intent was probably <code>assert v &gt; 0, &quot;Bad value&quot;</code>). This is a common programming error.",
       "default": "warning"
     },
     "reportSelfClsParameterName": {