Assert: minimal javadoc improvements
@@ -534,12 +534,12 @@ public interface Assert<S extends Assert<S, A>, A> extends Descriptable<S>, Exte
boolean equals(Object obj);
/**
- * In case of assertion error, the thread dump will be printed on {@link System#err}.
+ * In case of an assertion error, a thread dump will be printed to {@link System#err}.
* <p>
* Example :
* <pre><code class='java'> assertThat("Messi").withThreadDumpOnError().isEqualTo("Ronaldo");</code></pre>
*
- * will print the thread dump, something looking like:
+ * will print a thread dump, something similar to this:
* <pre>{@code "JDWP Command Reader"
* java.lang.Thread.State: RUNNABLE
*
@@ -583,9 +583,9 @@ public interface Assert<S extends Assert<S, A>, A> extends Descriptable<S>, Exte
/**
* Use the given {@link Representation} to describe/represent values in AssertJ error messages.
* <p>
- * The usual to introduce a new {@link Representation} is to extend {@link StandardRepresentation}
- * and override any existing {@code toStringOf} methods that don't suit you, as an example you could control
- * {@link Date} format by overriding {@link StandardRepresentation#toStringOf(Date)}).
+ * The usual way to introduce a new {@link Representation} is to extend {@link StandardRepresentation}
+ * and override any existing {@code toStringOf} methods that don't suit you. For example you can control
+ * {@link Date} formatting by overriding {@link StandardRepresentation#toStringOf(Date)}).
* <p>
* You can also control other types format by overriding {@link StandardRepresentation#toStringOf(Object)})
* calling your formatting method first and then fall back to the default representation by calling {@code super.toStringOf(Object)}.
@@ -599,7 +599,7 @@ public interface Assert<S extends Assert<S, A>, A> extends Descriptable<S>, Exte
* {@literal @}Override
* public String toStringOf(Object o) {
* if (o instanceof Example) return "Example";
- * // fallback to default formatting.
+ * // fall back to default formatting
* return super.toStringOf(o);
* }
*
