doc(starknet_client): fix doc and crate description. (#926)

docs(starknet_client): fix doc and crate description

crates/starknet_client/Cargo.toml

@@ -4,6 +4,7 @@ version.workspace = true
 edition.workspace = true
 repository.workspace = true
 license-file.workspace = true
+description = "A client implementation that can communicate with Starknet."
 
 [features]
 testing = [

crates/starknet_client/src/lib.rs

@@ -1,7 +1,6 @@
-//! Client implementation for the [`Starknet`] feeder gateway.
+//! This crate contains clients that can communicate with [`Starknet`] through the various
+//! endpoints [`Starknet`] has.
 //!
-//! This client can read data from [`Starknet`] about the current state
-//! (e.g accepted blocks, contracts, classes).
 //!
 //! [`Starknet`]: https://starknet.io/
 

crates/starknet_client/src/reader/mod.rs

@@ -1,3 +1,6 @@
+//! This module contains clients that can read data from [`Starknet`].
+//!
+//! [`Starknet`]: https://starknet.io/
 // TODO(shahak) Make private once ClientError is refactored and doesn't depend on the reader
 // module.
 pub(crate) mod objects;
@@ -30,7 +33,9 @@ use crate::{
     StarknetErrorCode,
 };
 
-/// Methods for querying starknet.
+/// A trait describing an object that can communicate with [`Starknet`] and read data from it.
+///
+/// [`Starknet`]: https://starknet.io/
 #[cfg_attr(any(test, feature = "testing"), automock)]
 #[async_trait]
 pub trait StarknetReader {
@@ -54,6 +59,9 @@ pub trait StarknetReader {
     async fn state_update(&self, block_number: BlockNumber) -> ClientResult<Option<StateUpdate>>;
 }
 
+/// A client for the [`Starknet`] feeder gateway.
+///
+/// [`Starknet`]: https://starknet.io/
 pub struct StarknetFeederGatewayClient {
     urls: StarknetUrls,
     client: StarknetClient,