diff --git a/src/lib/create_waku.ts b/src/lib/create_waku.ts
index 9c400911bc..50e9edc7c4 100644
--- a/src/lib/create_waku.ts
+++ b/src/lib/create_waku.ts
@@ -44,12 +44,7 @@ export interface CreateOptions {
    */
   staticNoiseKey?: Uint8Array;
   /**
-   * Use libp2p-bootstrap to discover and connect to new nodes.
-   *
-   * See [[BootstrapOptions]] for available parameters.
-   *
-   * Note: It overrides any other peerDiscovery modules that may have been set via
-   * {@link CreateOptions.libp2p}.
+   * Use recommended bootstrap method to discovery and connect to new nodes.
    */
   defaultBootstrap?: boolean;
 }
diff --git a/src/lib/wait_for_remote_peer.ts b/src/lib/wait_for_remote_peer.ts
index 87cd439d96..24917fa608 100644
--- a/src/lib/wait_for_remote_peer.ts
+++ b/src/lib/wait_for_remote_peer.ts
@@ -22,7 +22,8 @@ interface WakuGossipSubProtocol extends GossipSub {
 
 /**
  * Wait for a remote peer to be ready given the passed protocols.
- * Useful when using the [[CreateOptions.bootstrap]] with [[createWaku]].
+ * Must be used after attempting to connect to nodes, using {@link Waku.dial} or
+ * a bootstrap method with {@link Waku.constructor}.
  *
  * If the passed protocols is a GossipSub protocol, then it resolves only once
  * a peer is in a mesh, to help ensure that other peers will send and receive