From 7e9e00d1cdaf8a6d092af5e89afb1ef616ce1af0 Mon Sep 17 00:00:00 2001
From: /alex/ <alexander.schmidt@iota.org>
Date: Thu, 31 Oct 2024 17:02:14 +0100
Subject: [PATCH] chore(docs): improve iota-sdk docs (#3834)

---
 crates/iota-sdk/src/apis/read.rs |  7 ++++---
 crates/iota-sdk/src/lib.rs       | 12 ++++++------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/crates/iota-sdk/src/apis/read.rs b/crates/iota-sdk/src/apis/read.rs
index 14fe1f9f915..a334f457137 100644
--- a/crates/iota-sdk/src/apis/read.rs
+++ b/crates/iota-sdk/src/apis/read.rs
@@ -298,7 +298,7 @@ impl ReadApi {
             .await?)
     }
 
-    /// Return a [IotaObjectResponse] based on the provided [ObjectID] and
+    /// Return an [IotaObjectResponse] based on the provided [ObjectID] and
     /// [IotaObjectDataOptions], or an error upon failure.
     ///
     /// The [IotaObjectResponse] contains two fields:
@@ -456,8 +456,9 @@ impl ReadApi {
         Ok(*self.api.http.get_total_transaction_blocks().await?)
     }
 
-    /// Return a transaction and its effects in a [IotaTransactionBlockResponse]
-    /// based on its [TransactionDigest], or an error upon failure.
+    /// Return a transaction and its effects in an
+    /// [IotaTransactionBlockResponse] based on its [TransactionDigest], or
+    /// an error upon failure.
     pub async fn get_transaction_with_options(
         &self,
         digest: TransactionDigest,
diff --git a/crates/iota-sdk/src/lib.rs b/crates/iota-sdk/src/lib.rs
index 1a2c0268500..27ed64393c5 100644
--- a/crates/iota-sdk/src/lib.rs
+++ b/crates/iota-sdk/src/lib.rs
@@ -26,7 +26,7 @@
 //!
 //! # Usage
 //! The main way to interact with the API is through the [IotaClientBuilder],
-//! which returns a [IotaClient] object from which the user can access the
+//! which returns an [IotaClient] object from which the user can access the
 //! various APIs.
 //!
 //! ## Getting Started
@@ -195,7 +195,7 @@ impl IotaClientBuilder {
         self
     }
 
-    /// Returns a [IotaClient] object connected to the Iota network running at
+    /// Returns an [IotaClient] object connected to the Iota network running at
     /// the URI provided.
     ///
     /// # Examples
@@ -285,7 +285,7 @@ impl IotaClientBuilder {
         })
     }
 
-    /// Returns a [IotaClient] object that is ready to interact with the local
+    /// Returns an [IotaClient] object that is ready to interact with the local
     /// development network (by default it expects the Iota network to be
     /// up and running at `127.0.0.1:9000`).
     ///
@@ -308,7 +308,7 @@ impl IotaClientBuilder {
         self.build(IOTA_LOCAL_NETWORK_URL).await
     }
 
-    /// Returns a [IotaClient] object that is ready to interact with the Iota
+    /// Returns an [IotaClient] object that is ready to interact with the Iota
     /// devnet.
     ///
     /// For connecting to a custom URI, use the `build` function instead..
@@ -330,7 +330,7 @@ impl IotaClientBuilder {
         self.build(IOTA_DEVNET_URL).await
     }
 
-    /// Returns a [IotaClient] object that is ready to interact with the Iota
+    /// Returns an [IotaClient] object that is ready to interact with the Iota
     /// testnet.
     ///
     /// For connecting to a custom URI, use the `build` function instead.
@@ -404,7 +404,7 @@ impl IotaClientBuilder {
 ///
 /// # Usage
 ///
-/// Use [IotaClientBuilder] to build a [IotaClient].
+/// Use [IotaClientBuilder] to build an [IotaClient].
 ///
 /// # Examples
 ///