docs: correct documentation regarding bare url use and broken links

Author: Natchica

post-compute/src/api/result_proxy_api_client.rs

@@ -56,7 +56,7 @@ impl ResultProxyApiClient {
     ///
     /// # Arguments
     ///
-    /// * `base_url` - The base URL of the result proxy service (e.g., "https://result.v8-bellecour.iex.ec")
+    /// * `base_url` - The base URL of the result proxy service (e.g., "<https://result.v8-bellecour.iex.ec>")
     ///
     /// # Returns
     ///

post-compute/src/api/worker_api.rs

@@ -42,8 +42,8 @@ impl<'a> From<&'a ReplicateStatusCause> for ExitMessage<'a> {
 
 /// Thin wrapper around a [`Client`] that knows how to reach the iExec worker API.
 ///
-/// This client can be created directly with a base URL using [`new()`], or
-/// configured from environment variables using [`from_env()`].
+/// This client can be created directly with a base URL using [`WorkerApiClient::new`], or
+/// configured from environment variables using [`WorkerApiClient::from_env`].
 ///
 /// # Example
 ///
@@ -69,7 +69,7 @@ impl WorkerApiClient {
 
     /// Creates a new WorkerApiClient instance with configuration from environment variables.
     ///
-    /// This method retrieves the worker host from the [`WORKER_HOST_ENV_VAR`] environment variable.
+    /// This method retrieves the worker host from the [`TeeSessionEnvironmentVariable::WorkerHostEnvVar`] environment variable.
     /// If the variable is not set or empty, it defaults to `"worker:13100"`.
     ///
     /// # Returns
@@ -108,11 +108,11 @@ impl WorkerApiClient {
     /// # Returns
     ///
     /// * `Ok(())` - If the exit cause was successfully reported
-    /// * `Err(Error)` - If the exit cause could not be reported due to an HTTP error
+    /// * `Err(ReplicateStatusCause)` - If the exit cause could not be reported due to an HTTP error
     ///
     /// # Errors
     ///
-    /// This function will return an [`Error`] if the request could not be sent or
+    /// 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.
     ///
     /// # Example

post-compute/src/compute/app_runner.rs

@@ -43,7 +43,7 @@ pub trait PostComputeRunnerInterface {
 /// Production implementation of [`PostComputeRunnerInterface`]
 ///
 /// This struct provides a concrete implementation of the [`PostComputeRunnerInterface`],
-/// using the [`signer`] module for challenge generation and the owned [`WorkerApiClient`]
+/// using the [`super::signer`] module for challenge generation and the owned [`WorkerApiClient`]
 /// instance for error reporting.
 pub struct DefaultPostComputeRunner {
     worker_api_client: WorkerApiClient,

post-compute/src/compute/web2_result.rs

@@ -31,7 +31,7 @@ const DROPBOX_RESULT_STORAGE_PROVIDER: &str = "dropbox";
 ///
 /// The trait methods represent the main stages of the result processing workflow:
 /// validation, compression, and upload. Each method can be used independently or
-/// as part of the complete workflow provided by [`encrypt_and_upload_result`].
+/// as part of the complete workflow provided by [`Web2ResultInterface::encrypt_and_upload_result`].
 ///
 ///
 /// # Example Implementation