Apply review suggestions

Author: theinfosecguy

cpp/ql/src/Likely Bugs/Likely Typos/AmbiguousAssignmentOfComparison.qhelp

@@ -11,14 +11,14 @@ first and then compare it with zero.</p>
 </overview>
 
 <recommendation>
-<p>Use parentheses to make the intended operation order explicit. To assign first and compare the
+<p>Use parentheses to make the intended order of operations explicit. To assign first and compare the
 assigned value, parenthesize the assignment. To intentionally assign the comparison result,
 parenthesize the comparison. An explicit cast around the comparison also makes that order clear.</p>
 </recommendation>
 
 <example>
 <p>In the first condition, <code>status</code> receives either zero or one instead of the value
-returned by <code>read_status</code>. The second condition explicitly performs the assignment
+returned by <code>read_status()</code>. The second condition explicitly performs the assignment
 before the comparison.</p>
 <sample src="AmbiguousAssignmentOfComparison.cpp" />
 </example>

cpp/ql/src/Likely Bugs/Likely Typos/AmbiguousAssignmentOfComparison.ql

@@ -1,8 +1,7 @@
 /**
- * @name Ambiguous assignment of comparison used as truth value
- * @description Assigning the result of an unparenthesized comparison when the assignment is used
- *              as a truth value may indicate that the assignment and comparison are grouped
- *              incorrectly.
+ * @name Ambiguous assignment of comparison result used as truth value
+ * @description Using an assignment of an unparenthesized comparison as
+ *              a truth value may indicate unintended operator grouping.
  * @kind problem
  * @problem.severity warning
  * @precision high

cpp/ql/src/change-notes/2026-08-13-ambiguous-assignment-of-comparison.md

@@ -1,5 +1,6 @@
 ---
 category: newQuery
 ---
-* Added a new query, `cpp/ambiguous-assignment-of-comparison`, to detect assignments of
-  unparenthesized comparison results when the assignment is used as a truth value.
+* Added a new query, `cpp/ambiguous-assignment-of-comparison`, to detect potentially
+  ambiguous expressions where a comparison result is assigned to a variable and the
+  assignment is used as a truth value.