LambdaBootstrapBuilder documentation is wrong / misleading

[tmitchel2]

Describe the issue

https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html has a section which has the following

await LambdaBootstrapBuilder.Create<APIGatewayProxyRequest>(Handler, new DefaultLambdaJsonSerializer())
    .Build()
    .RunAsync();

This is incorrect because the handler will be treated as not having a response type (will just be treated as Task) and the response will not serialized back to the api gateway. This then leads to a malformed response exception which is incredibly hard to diagnose. TBH the code allows for this behaviour a bit too readily.

Anyway the documentation should include the response type as a generic to work correctly...

await LambdaBootstrapBuilder.Create<APIGatewayProxyRequest, APIGatewayProxyResponse>(Handler, new DefaultLambdaJsonSerializer())
    .Build()
    .RunAsync();

Links

https://docs.aws.amazon.com/lambda/latest/dg/csharp-handler.html

[bhoradc]

Hi @tmitchel2,

Thank you for submitting the issue. We'll verify the proposed documentation changes and forward the request to the service team accordingly.

Regards,
Chaitanya