docs: fixes

Author: nbbeeken

src/collection.ts

@@ -1547,8 +1547,10 @@ export class Collection<TSchema extends Document = Document> {
   /**
    * Initiate an Out of order batch write operation. All operations will be buffered into insert/update/remove commands executed out of order.
    *
+   * @throws MongoNotConnectedError
    * @remarks
-   * **NOTE:** MongoClient must be connected prior to calling this API.
+   * **NOTE:** MongoClient must be connected prior to calling this method due to a known limitation in this legacy implemenation.
+   * However, `collection.bulkWrite()` provides an equivalent API that does not require prior connecting.
    */
   initializeUnorderedBulkOp(options?: BulkWriteOptions): UnorderedBulkOperation {
     return new UnorderedBulkOperation(this as TODO_NODE_3286, resolveOptions(this, options));
@@ -1557,8 +1559,10 @@ export class Collection<TSchema extends Document = Document> {
   /**
    * Initiate an In order bulk write operation. Operations will be serially executed in the order they are added, creating a new operation for each switch in types.
    *
+   * @throws MongoNotConnectedError
    * @remarks
-   * **NOTE:** MongoClient must be connected prior to calling this API.
+   * **NOTE:** MongoClient must be connected prior to calling this method due to a known limitation in this legacy implemenation.
+   * However, `collection.bulkWrite()` provides an equivalent API that does not require prior connecting.
    */
   initializeOrderedBulkOp(options?: BulkWriteOptions): OrderedBulkOperation {
     return new OrderedBulkOperation(this as TODO_NODE_3286, resolveOptions(this, options));