Apply suggestions from code review

Co-authored-by: mc <[email protected]>

Author: atorralba

java/change-notes/2021-06-18-insecure-java-mail-query.md

@@ -1,2 +1,2 @@
 lgtm,codescanning
-* The query "Insecure JavaMail SSL Configuration" (`java/insecure-smtp-ssl`) has been promoted from experimental to the main query pack. Its results will now appear by default. This query was originally [submitted as an experimental query by @luchua-bc](https://github.com/github/codeql/pull/3491)
+* The query "Insecure JavaMail SSL Configuration" (`java/insecure-smtp-ssl`) has been promoted from experimental to the main query pack. Its results will now appear by default. This query was originally [submitted as an experimental query by @luchua-bc](https://github.com/github/codeql/pull/3491).

java/ql/src/Security/CWE/CWE-297/InsecureJavaMail.ql

@@ -1,8 +1,8 @@
 /**
  * @name Insecure JavaMail SSL Configuration
- * @description Java application configured to use authenticated mail session
- *              over SSL does not validate the SSL certificate to properly
- *              ensure that it is actually associated with that host.
+ * @description Configuring a Java application to use authenticated mail session
+ *              over SSL without certificate validation
+ *              makes the session susceptible to a man-in-the-middle attack.
  * @kind problem
  * @problem.severity warning
  * @precision medium