Javadocs fix

Author: slinkydeveloper

sdk-api/src/main/java/dev/restate/sdk/Context.java

@@ -445,7 +445,7 @@ default Awaitable<Void> runAsync(ThrowingRunnable runnable) throws TerminalExcep
    * service consume from Kafka the responses of given external system interaction by using {@link
    * #awakeableHandle(String)}.
    *
-   * @param clazz the response type to use for deserializing the {@link Awakeable} result.
+   * @param clazz the response type to use for deserializing the {@link Awakeable} result. When using generic types, use {@link #awakeable(TypeTag)} instead.
    * @return the {@link Awakeable} to await on.
    * @see Awakeable
    */
@@ -462,7 +462,6 @@ default <T> Awakeable<T> awakeable(Class<T> clazz) {
    * #awakeableHandle(String)}.
    *
    * @param typeTag the response type tag to use for deserializing the {@link Awakeable} result.
-   *     When using generic types, use {@link #awakeable(TypeRef)} instead.
    * @return the {@link Awakeable} to await on.
    * @see Awakeable
    */

sdk-api/src/main/java/dev/restate/sdk/RestateRandom.java

@@ -20,10 +20,9 @@
  *
  * <p>This instance is useful to generate identifiers, idempotency keys, and for uniform sampling
  * from a set of options. If a cryptographically secure value is needed, please generate that
- * externally using {@link ObjectContext#run(Serde, ThrowingSupplier)}.
+ * externally using {@link Context#run(String, Class, ThrowingSupplier)}.
  *
- * <p>You <b>MUST NOT</b> use this object inside a {@link ObjectContext#run(Serde,
- * ThrowingSupplier)}.
+ * <p>You <b>MUST NOT</b> use this object inside a {@link Context#run(String, Class, ThrowingSupplier)}/{@link Context#runAsync(String, Class, ThrowingSupplier)}.
  */
 public class RestateRandom extends Random {