doc update

Author: HJLebbink

src/s3/client/bucket_exists.rs

@@ -20,7 +20,26 @@ use crate::s3::builders::BucketExists;
 use std::sync::Arc;
 
 impl Client {
-    /// Create a BucketExists request builder.
+    /// Creates a [`BucketExists`](crate::s3::builders::BucketExists) request builder.
+    ///
+    /// To execute the request, call [`BucketExists::send`](crate::s3::types::S3Api::send),
+    /// which returns a [`Result`] containing a [`BucketExistsResponse`](crate::s3::response::BucketExistsResponse).    
+    /// 
+    /// # Examples
+    ///
+    /// ```no_run
+    /// use minio::s3::Client;
+    /// use minio::s3::response::BucketExistsResponse;
+    /// use minio::s3::types::S3Api;
+    /// use std::sync::Arc;
+    ///
+    /// #[tokio::main]
+    /// async fn main() {    
+    ///     let client: Arc<Client> = Arc::new(Default::default()); // configure your client here
+    ///     let resp: BucketExistsResponse = client.bucket_exists("bucket-name").send().await.unwrap();
+    ///     println!("bucket '{}' exists: {}", resp.bucket, resp.exists);
+    /// }
+    /// ```
     pub fn bucket_exists(self: &Arc<Self>, bucket: &str) -> BucketExists {
         BucketExists::new(self, bucket)
     }