[java] fix javadocs for error messages

titusfortner · titusfortner · commit f4049f40a49c · 2022-03-28T15:50:43.000-05:00
diff --git a/java/src/org/openqa/selenium/ElementNotInteractableException.java b/java/src/org/openqa/selenium/ElementNotInteractableException.java
@@ -18,8 +18,9 @@
 package org.openqa.selenium;
 
 /**
- * Thrown to indicate that although an element is present on the DOM, it is not in a state that can
- * be interacted with.
+ * Thrown to indicate that although a {@link WebElement} is present on the DOM, it is not in a state that can
+ * be interacted with. This includes an element that is not displayed or whose center point
+ * can not be scrolled into the viewport.
  */
 public class ElementNotInteractableException extends InvalidElementStateException {
   public ElementNotInteractableException(String message) {
diff --git a/java/src/org/openqa/selenium/InvalidElementStateException.java b/java/src/org/openqa/selenium/InvalidElementStateException.java
@@ -19,8 +19,7 @@
 
 /**
  * Indicates that a {@link WebElement} is in a state that means actions cannot be performed with it.
- * Examples would include an element being obscured by another when clicking, or perhaps not being
- * visible on the DOM. Subclasses of this provide more detailed information.
+ * For example, attempting to clear an element that isn’t both editable and resettable.
  */
 public class InvalidElementStateException extends WebDriverException {
   public InvalidElementStateException() {
