.

jlizen · jlizen · commit 521d0e1077b4 · 2025-05-27T16:53:51.000Z
diff --git a/.github/workflows/check-docs.yml b/.github/workflows/check-docs.yml
@@ -36,4 +36,4 @@ jobs:
         env:
             RUSTFLAGS: --cfg docsrs 
             RUSTDOCFLAGS: --cfg docsrs -Dwarnings
-        run: cargo doc --document-private-items --all-features
+        run: cargo doc --no-deps --document-private-items --all-features
diff --git a/examples/advanced-sqs-partial-batch-failures/src/main.rs b/examples/advanced-sqs-partial-batch-failures/src/main.rs
@@ -44,7 +44,7 @@ async fn main() -> Result<(), Error> {
 /// Important note: your lambda sqs trigger *needs* to be configured with partial batch response support
 /// with the ` ReportBatchItemFailures` flag set to true, otherwise failed message will be dropped,
 /// for more details see:
-/// https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-batchfailurereporting
+/// <https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-batchfailurereporting>
 ///
 ///
 /// Note that if you are looking for parallel processing (multithread) instead of concurrent processing,
diff --git a/examples/http-basic-lambda/src/main.rs b/examples/http-basic-lambda/src/main.rs
@@ -3,7 +3,7 @@ use lambda_http::{run, service_fn, tracing, Body, Error, Request, Response};
 /// This is the main body for the function.
 /// Write your code inside it.
 /// There are some code examples in the Runtime repository:
-/// - https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples
+/// - <https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples>
 async fn function_handler(_event: Request) -> Result<Response<Body>, Error> {
     // Extract some useful information from the request
 
diff --git a/examples/http-dynamodb/src/main.rs b/examples/http-dynamodb/src/main.rs
@@ -15,7 +15,7 @@ pub struct Item {
 /// This is the main body for the function.
 /// Write your code inside it.
 /// You can see more examples in Runtime's repository:
-/// - https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples
+/// - <https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples>
 async fn handle_request(db_client: &Client, event: Request) -> Result<Response<Body>, Error> {
     // Extract some useful information from the request
     let body = event.body();
diff --git a/examples/http-query-parameters/src/main.rs b/examples/http-query-parameters/src/main.rs
@@ -3,7 +3,7 @@ use lambda_http::{run, service_fn, tracing, Error, IntoResponse, Request, Reques
 /// This is the main body for the function.
 /// Write your code inside it.
 /// You can see more examples in Runtime's repository:
-/// - https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples
+/// - <https://github.com/awslabs/aws-lambda-rust-runtime/tree/main/examples>
 async fn function_handler(event: Request) -> Result<impl IntoResponse, Error> {
     // Extract some useful information from the request
     Ok(
diff --git a/lambda-events/src/custom_serde/float_unix_epoch.rs b/lambda-events/src/custom_serde/float_unix_epoch.rs
@@ -57,7 +57,6 @@ where
 struct SecondsFloatTimestampVisitor;
 
 /// Serialize a UTC datetime into an float number of seconds since the epoch
-/// ```
 pub fn serialize<S>(dt: &DateTime<Utc>, serializer: S) -> Result<S::Ok, S::Error>
 where
     S: ser::Serializer,
diff --git a/lambda-events/src/custom_serde/headers.rs b/lambda-events/src/custom_serde/headers.rs
@@ -5,7 +5,7 @@ use serde::{
 };
 use std::{borrow::Cow, fmt};
 
-/// Serialize a http::HeaderMap into a serde str => Vec<str> map
+/// Serialize a http::HeaderMap into a serde str => `Vec<str>` map
 pub(crate) fn serialize_multi_value_headers<S>(headers: &HeaderMap, serializer: S) -> Result<S::Ok, S::Error>
 where
     S: Serializer,
diff --git a/lambda-events/src/event/appsync/mod.rs b/lambda-events/src/event/appsync/mod.rs
@@ -4,7 +4,7 @@ use std::collections::HashMap;
 
 use crate::custom_serde::deserialize_lambda_map;
 
-/// Deprecated: `AppSyncResolverTemplate` does not represent resolver events sent by AppSync. Instead directly model your input schema, or use map[string]string, json.RawMessage, interface{}, etc..
+/// Deprecated: `AppSyncResolverTemplate` does not represent resolver events sent by AppSync. Instead directly model your input schema, or use `map[string]string`, `json.RawMessage`,` interface{}`, etc..
 #[derive(Debug, Clone, Eq, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AppSyncResolverTemplate<T1 = Value>
diff --git a/lambda-events/src/event/cloudwatch_events/mod.rs b/lambda-events/src/event/cloudwatch_events/mod.rs
@@ -20,7 +20,7 @@ pub mod tag;
 pub mod trustedadvisor;
 
 /// `CloudWatchEvent` is the outer structure of an event sent via CloudWatch Events.
-/// For examples of events that come via CloudWatch Events, see https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html
+/// For examples of events that come via CloudWatch Events, see <https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html>
 #[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CloudWatchEvent<T1 = Value>
diff --git a/lambda-events/src/event/codebuild/mod.rs b/lambda-events/src/event/codebuild/mod.rs
@@ -11,7 +11,7 @@ pub type CodeBuildPhaseStatus = String;
 pub type CodeBuildPhaseType = String;
 
 /// `CodeBuildEvent` is documented at:
-/// https://docs.aws.amazon.com/codebuild/latest/userguide/sample-build-notifications.html#sample-build-notifications-ref
+/// <https://docs.aws.amazon.com/codebuild/latest/userguide/sample-build-notifications.html#sample-build-notifications-ref>
 #[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CodeBuildEvent {
diff --git a/lambda-events/src/event/codedeploy/mod.rs b/lambda-events/src/event/codedeploy/mod.rs
@@ -4,7 +4,7 @@ use serde::{Deserialize, Serialize};
 pub type CodeDeployDeploymentState = String;
 
 /// `CodeDeployEvent` is documented at:
-/// https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#acd_event_types
+/// <https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#acd_event_types>
 #[derive(Debug, Clone, Eq, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CodeDeployEvent {
diff --git a/lambda-events/src/event/codepipeline_cloudwatch/mod.rs b/lambda-events/src/event/codepipeline_cloudwatch/mod.rs
@@ -8,7 +8,7 @@ pub type CodePipelineState = String;
 pub type CodePipelineActionState = String;
 
 /// CodePipelineEvent is documented at:
-/// https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#codepipeline_event_type
+/// <https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#codepipeline_event_type>
 #[derive(Debug, Clone, Eq, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CodePipelineCloudWatchEvent {
diff --git a/lambda-events/src/event/dynamodb/mod.rs b/lambda-events/src/event/dynamodb/mod.rs
@@ -118,7 +118,7 @@ pub struct Event {
 }
 
 /// `TimeWindowEvent` represents an Amazon Dynamodb event when using time windows
-/// ref. https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows
+/// ref. <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows>
 #[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeWindowEvent {
@@ -216,7 +216,7 @@ pub struct UserIdentity {
 pub struct StreamRecord {
     /// The approximate date and time when the stream record was created, in UNIX
     /// epoch time (http://www.epochconverter.com/) format. Might not be present in
-    /// the record: https://github.com/awslabs/aws-lambda-rust-runtime/issues/889
+    /// the record: <https://github.com/awslabs/aws-lambda-rust-runtime/issues/889>
     #[serde(rename = "ApproximateCreationDateTime")]
     #[serde(with = "float_unix_epoch")]
     #[serde(default)]
diff --git a/lambda-events/src/event/iot/mod.rs b/lambda-events/src/event/iot/mod.rs
@@ -3,7 +3,7 @@ use http::HeaderMap;
 use serde::{Deserialize, Serialize};
 
 /// `IoTCoreCustomAuthorizerRequest` represents the request to an IoT Core custom authorizer.
-/// <See https://docs.aws.amazon.com/iot/latest/developerguide/config-custom-auth.html>
+/// See <https://docs.aws.amazon.com/iot/latest/developerguide/config-custom-auth.html>
 #[derive(Debug, Clone, Eq, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IoTCoreCustomAuthorizerRequest {
@@ -58,7 +58,7 @@ pub struct IoTCoreConnectionMetadata {
 }
 
 /// `IoTCoreCustomAuthorizerResponse` represents the response from an IoT Core custom authorizer.
-/// <See https://docs.aws.amazon.com/iot/latest/developerguide/config-custom-auth.html>
+/// See <https://docs.aws.amazon.com/iot/latest/developerguide/config-custom-auth.html>
 #[derive(Debug, Clone, Eq, PartialEq, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IoTCoreCustomAuthorizerResponse {
diff --git a/lambda-events/src/event/kinesis/event.rs b/lambda-events/src/event/kinesis/event.rs
@@ -12,7 +12,7 @@ pub struct KinesisEvent {
 }
 
 /// `KinesisTimeWindowEvent` represents an Amazon Dynamodb event when using time windows
-/// ref. https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows
+/// ref. <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows>
 #[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct KinesisTimeWindowEvent {
diff --git a/lambda-events/src/event/s3/object_lambda.rs b/lambda-events/src/event/s3/object_lambda.rs
@@ -6,7 +6,7 @@ use std::collections::HashMap;
 use crate::custom_serde::{deserialize_headers, serialize_headers};
 
 /// `S3ObjectLambdaEvent` contains data coming from S3 object lambdas
-/// See: https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-writing-lambda.html
+/// See: <https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-writing-lambda.html>
 #[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct S3ObjectLambdaEvent<P = Value>
diff --git a/lambda-events/src/time_window.rs b/lambda-events/src/time_window.rs
@@ -5,8 +5,8 @@ use std::collections::HashMap;
 use crate::custom_serde::deserialize_lambda_map;
 
 /// `Window` is the object that captures the time window for the records in the event when using the tumbling windows feature
-/// Kinesis: https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows
-/// DDB: https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows
+/// Kinesis: <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows>
+/// DDB: <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows>
 #[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct Window {
@@ -24,8 +24,8 @@ impl Default for Window {
 }
 
 /// `TimeWindowProperties` is the object that captures properties that relate to the tumbling windows feature
-/// Kinesis: https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows
-/// DDB: https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows
+/// Kinesis: <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows>
+/// DDB: <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows>
 #[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeWindowProperties {
@@ -51,8 +51,8 @@ pub struct TimeWindowProperties {
 }
 
 /// `TimeWindowEventResponseProperties` is the object that captures response properties that relate to the tumbling windows feature
-/// Kinesis: https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows
-/// DDB: https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows
+/// Kinesis: <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-windows>
+/// DDB: <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-windows>
 #[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeWindowEventResponseProperties {
diff --git a/lambda-extension/src/logs.rs b/lambda-extension/src/logs.rs
@@ -12,7 +12,7 @@ use tracing::{error, trace};
 use crate::{Error, ExtensionError};
 
 /// Payload received from the Lambda Logs API
-/// See: https://docs.aws.amazon.com/lambda/latest/dg/runtimes-logs-api.html#runtimes-logs-api-msg
+/// See: <https://docs.aws.amazon.com/lambda/latest/dg/runtimes-logs-api.html#runtimes-logs-api-msg>
 #[derive(Clone, Debug, Deserialize, PartialEq)]
 pub struct LambdaLog {
     /// Time when the log was generated
diff --git a/lambda-runtime-api-client/src/body/channel.rs b/lambda-runtime-api-client/src/body/channel.rs
@@ -1,5 +1,5 @@
 //! Body::channel utilities. Extracted from Hyper under MIT license.
-//! https://github.com/hyperium/hyper/blob/master/LICENSE
+//! <https://github.com/hyperium/hyper/blob/master/LICENSE>
 
 use std::{
     pin::Pin,
@@ -31,7 +31,7 @@ impl DecodedLength {
         }
     }
 
-    /// Converts to an Option<u64> representing a Known or Unknown length.
+    /// Converts to an `Option<u64>` representing a Known or Unknown length.
     pub(crate) fn into_opt(self) -> Option<u64> {
         match self {
             DecodedLength::CHUNKED | DecodedLength::CLOSE_DELIMITED => None,
diff --git a/lambda-runtime-api-client/src/body/mod.rs b/lambda-runtime-api-client/src/body/mod.rs
@@ -1,5 +1,5 @@
 //! HTTP body utilities. Extracted from Axum under MIT license.
-//! https://github.com/tokio-rs/axum/blob/main/axum/LICENSE
+//! <https://github.com/tokio-rs/axum/blob/main/axum/LICENSE>
 
 use crate::{BoxError, Error};
 use bytes::Bytes;
diff --git a/lambda-runtime-api-client/src/body/sender.rs b/lambda-runtime-api-client/src/body/sender.rs
@@ -1,5 +1,5 @@
 //! Body::channel utilities. Extracted from Hyper under MIT license.
-//! https://github.com/hyperium/hyper/blob/master/LICENSE
+//! <https://github.com/hyperium/hyper/blob/master/LICENSE>
 
 use crate::Error;
 use std::task::{Context, Poll};
diff --git a/lambda-runtime-api-client/src/body/watch.rs b/lambda-runtime-api-client/src/body/watch.rs
@@ -1,5 +1,5 @@
 //! Body::channel utilities. Extracted from Hyper under MIT license.
-//! https://github.com/hyperium/hyper/blob/master/LICENSE
+//! <https://github.com/hyperium/hyper/blob/master/LICENSE>
 
 //! An SPSC broadcast channel.
 //!
diff --git a/lambda-runtime-api-client/src/error.rs b/lambda-runtime-api-client/src/error.rs
@@ -1,5 +1,5 @@
 //! Extracted from Axum under MIT license.
-//! https://github.com/tokio-rs/axum/blob/main/axum/LICENSE
+//! <https://github.com/tokio-rs/axum/blob/main/axum/LICENSE>
 use std::{error::Error as StdError, fmt};
 pub use tower::BoxError;
 /// Errors that can happen when using axum.
diff --git a/lambda-runtime-api-client/src/tracing.rs b/lambda-runtime-api-client/src/tracing.rs
@@ -42,7 +42,7 @@ pub fn init_default_subscriber() {
 ///
 /// You might want to avoid writing to STDOUT in the local context via [`init_default_subscriber()`], if you have a high-throughput Lambdas that involve
 /// a lot of async concurrency. Since, writing to STDOUT can briefly block your tokio runtime - ref [tracing #2653](https://github.com/tokio-rs/tracing/issues/2653).
-/// In that case, you might prefer to use [tracing_appender::NonBlocking] instead - particularly if your Lambda is fairly long-running and stays warm.
+/// In that case, you might prefer to use [tracing_appender::NonBlocking](https://docs.rs/tracing-appender/latest/tracing_appender/non_blocking/struct.NonBlocking.html) instead - particularly if your Lambda is fairly long-running and stays warm.
 /// Though, note that you are then responsible
 /// for ensuring gracefuls shutdown. See [`examples/graceful-shutdown`] for a complete example.
 ///
diff --git a/lambda-runtime/src/layers/otel.rs b/lambda-runtime/src/layers/otel.rs
@@ -131,7 +131,7 @@ where
 }
 
 /// Represent the possible values for the OpenTelemetry `faas.trigger` attribute.
-/// <See https://opentelemetry.io/docs/specs/semconv/attributes-registry/faas/> for more details.
+/// See <https://opentelemetry.io/docs/specs/semconv/attributes-registry/faas/> for more details.
 #[derive(Default, Clone, Copy)]
 #[non_exhaustive]
 pub enum OpenTelemetryFaasTrigger {
