Minor javadoc improvements

Author: jhalterman

src/main/java/dev/failsafe/CircuitBreaker.java

@@ -60,6 +60,8 @@ public interface CircuitBreaker<R> extends Policy<R> {
    * CircuitBreakerBuilder#withFailureThreshold(int) single failure}, closes after a {@link
    * CircuitBreakerBuilder#withSuccessThreshold(int) single success}, and has a 1 minute {@link
    * CircuitBreakerBuilder#withDelay(Duration) delay}, unless configured otherwise.
+   *
+   * @see #ofDefaults()
    */
   static <R> CircuitBreakerBuilder<R> builder() {
     return new CircuitBreakerBuilder<>();
@@ -76,6 +78,8 @@ static <R> CircuitBreakerBuilder<R> builder(CircuitBreakerConfig<R> config) {
    * Creates a count based CircuitBreaker that opens after a {@link CircuitBreakerBuilder#withFailureThreshold(int)
    * single failure}, closes after a {@link CircuitBreakerBuilder#withSuccessThreshold(int) single success}, and has a 1
    * minute {@link CircuitBreakerBuilder#withDelay(Duration) delay} by default.
+   *
+   * @see #builder()
    */
   static <R> CircuitBreaker<R> ofDefaults() {
     return CircuitBreaker.<R>builder().build();
@@ -105,6 +109,7 @@ enum State {
    *
    * @throws CircuitBreakerOpenException Thrown when the circuit breaker is in a half-open state and no permits remain
    * according to the configured success or failure thresholding capacity.
+   * @see #tryAcquirePermit()
    * @see #recordResult(Object)
    * @see #recordFailure(Throwable)
    * @see #recordSuccess()
@@ -116,7 +121,7 @@ default void acquirePermit() {
   }
 
   /**
-   * Attempts to acquire a permit to use the circuit breaker and returns whether a permit was acquired. Permission will
+   * Tries to acquire a permit to use the circuit breaker and returns whether a permit was acquired. Permission will
    * be automatically released when a result or failure is recorded.
    *
    * @see #recordResult(Object)

src/main/java/dev/failsafe/RetryPolicy.java

@@ -30,6 +30,8 @@ public interface RetryPolicy<R> extends Policy<R> {
   /**
    * Creates a RetryPolicyBuilder that by default will build a RetryPolicy that allows 3 execution attempts max with no
    * delay, unless configured otherwise.
+   *
+   * @see #ofDefaults()
    */
   static <R> RetryPolicyBuilder<R> builder() {
     return new RetryPolicyBuilder<>();
@@ -44,6 +46,8 @@ static <R> RetryPolicyBuilder<R> builder(RetryPolicyConfig<R> config) {
 
   /**
    * Creates a RetryPolicy that allows 3 execution attempts max with no delay.
+   *
+   * @see #builder() 
    */
   static <R> RetryPolicy<R> ofDefaults() {
     return RetryPolicy.<R>builder().build();

src/main/java/dev/failsafe/TimeoutBuilder.java

@@ -23,7 +23,7 @@
 /**
  * Builds {@link Timeout} instances.
  * <p>
- * This class is threadsafe.
+ * This class is <i>not</i> threadsafe.
  * </p>
  *
  * @param <R> result type