docs: improve documentation formatting and clarity

Author: Natchica

post-compute/src/api/result_proxy_api_client.rs

@@ -110,7 +110,10 @@ impl ResultProxyApiClient {
     /// # Example
     ///
     /// ```rust
-    /// use tee_worker_post_compute::api::result_proxy_api_client::{ResultProxyApiClient, ResultModel};
+    /// use tee_worker_post_compute::api::result_proxy_api_client::{
+    ///     ResultProxyApiClient,
+    ///     ResultModel,
+    /// };
     ///
     /// let client = ResultProxyApiClient::new("https://result-proxy.iex.ec");
     /// let result_model = ResultModel {

post-compute/src/api/worker_api.rs

@@ -24,8 +24,10 @@ use serde::Serialize;
 /// # Example
 ///
 /// ```
-/// use tee_worker_post_compute::api::worker_api::ExitMessage;
-/// use tee_worker_post_compute::compute::errors::ReplicateStatusCause;
+/// use tee_worker_post_compute::{
+///     api::worker_api::ExitMessage,
+///     compute::errors::ReplicateStatusCause,
+/// };
 ///
 /// let exit_message = ExitMessage::from(&ReplicateStatusCause::PostComputeInvalidTeeSignature);
 /// ```
@@ -112,14 +114,16 @@ impl WorkerApiClient {
     ///
     /// # Errors
     ///
-    /// This function will return an [`crate::compute::errors::ReplicateStatusCause`] if the request could not be sent or
-    /// the server responded with a non‑success status.
+    /// This function will return an [`tee_worker_post_compute::compute::errors::ReplicateStatusCause`]
+    /// if the request could not be sent or the server responded with a non‑success status.
     ///
     /// # Example
     ///
     /// ```
-    /// use tee_worker_post_compute::api::worker_api::{ExitMessage, WorkerApiClient};
-    /// use tee_worker_post_compute::compute::errors::ReplicateStatusCause;
+    /// use tee_worker_post_compute::{
+    ///     api::worker_api::{ExitMessage, WorkerApiClient},
+    ///     compute::errors::ReplicateStatusCause,
+    /// };
     ///
     /// let client = WorkerApiClient::new("http://worker:13100");
     /// let exit_message = ExitMessage::from(&ReplicateStatusCause::PostComputeInvalidTeeSignature);
@@ -186,8 +190,10 @@ impl WorkerApiClient {
     /// # Example
     ///
     /// ```
-    /// use tee_worker_post_compute::api::worker_api::WorkerApiClient;
-    /// use tee_worker_post_compute::compute::computed_file::ComputedFile;
+    /// use tee_worker_post_compute::{
+    ///     api::worker_api::WorkerApiClient,
+    ///     compute::computed_file::ComputedFile,
+    /// };
     ///
     /// let client = WorkerApiClient::new("http://worker:13100");
     /// let computed_file = ComputedFile {

post-compute/src/compute/app_runner.rs

@@ -153,7 +153,6 @@ impl PostComputeRunnerInterface for DefaultPostComputeRunner {
 /// use tee_worker_post_compute::compute::app_runner::{
 ///     start_with_runner,
 ///     DefaultPostComputeRunner,
-///     PostComputeRunnerInterface,
 /// };
 ///
 /// // Using the default runner

post-compute/src/compute/dropbox.rs

@@ -21,7 +21,7 @@ const FILES_UPLOAD_PATH: &str = "/2/files/upload";
 
 /// Service for handling Dropbox file uploads.
 ///
-/// This is a lightweight utility type. Construct with `let service = DropboxService;` and call
+/// This is a lightweight utility type. Use with `DropboxService` and call
 /// [`DropboxService::upload_file`].
 ///
 /// # Example
@@ -33,8 +33,7 @@ const FILES_UPLOAD_PATH: &str = "/2/files/upload";
 ///     DropboxUploader,
 /// };
 ///
-/// let service = DropboxService;
-/// let result = service.upload_file(
+/// let result = DropboxService.upload_file(
 ///     "your-access-token",
 ///     "/path/to/local/file.zip",
 ///     "/results/remote-file.zip",

post-compute/src/compute/web2_result.rs

@@ -86,7 +86,6 @@ pub trait Web2ResultInterface {
 ///     computed_file::ComputedFile,
 /// };
 ///
-/// let service = Web2ResultService;
 /// let computed_file = ComputedFile {
 ///     task_id: Some(String::from("0x123")),
 ///     result_digest: Some(String::from("0xabc")),
@@ -95,7 +94,7 @@ pub trait Web2ResultInterface {
 /// };
 ///
 /// // Process and upload results
-/// match service.encrypt_and_upload_result(&computed_file) {
+/// match Web2ResultService.encrypt_and_upload_result(&computed_file) {
 ///     Ok(()) => println!("Results uploaded successfully"),
 ///     Err(e) => eprintln!("Upload failed: {:?}", e),
 /// }