docs: ASP.NET Core WebAPI example(s)

[swimming-potato]

Issue number: #220

Summary

Changes

Introduce an example for ASP.Net WebAPI deployed on AWS Lambda.

User experience

This is a change in documentation. A section ServerlessAPi has been added to the examples. The section demonstrates to AWS Lambda Powertools users: how to leverage logging, metrics and tracing provided by AWS Lambda Powertools in the WebAPI hosted by Kestrel. It contains the code and README.md file to walkthrough the changes.

Checklist

Please leave checklist items unchecked if they do not apply to your change.

• Meets tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

No **RFC issue number**:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.01 🎉

Comparison is base (dba5e90) 69.09% compared to head (29bda6b) 69.11%.

❗ Your organization is not using the GitHub App Integration. As a result you may experience degraded service beginning May 15th. Please install the Github App Integration for your organization. Read more.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #287      +/-   ##
===========================================
+ Coverage    69.09%   69.11%   +0.01%     
===========================================
  Files           79       79              
  Lines         3433     3448      +15     
===========================================
+ Hits          2372     2383      +11     
- Misses        1061     1065       +4     

Flag	Coverage Δ
unittests	69.11% <100.00%> (+0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...aries/src/AWS.Lambda.Powertools.Metrics/Metrics.cs	85.07% <100.00%> (+0.69%)	⬆️
...rc/AWS.Lambda.Powertools.Metrics/Model/Metadata.cs	98.03% <100.00%> (+0.12%)	⬆️
...Lambda.Powertools.Metrics/Model/MetricDirective.cs	86.04% <100.00%> (+0.50%)	⬆️
....Lambda.Powertools.Metrics/Model/MetricsContext.cs	100.00% <100.00%> (ø)

... and 2 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[amirkaws]

Unit test is breaking because the FunctionVersion is null

to solve that we can set the FunctionVersion

Amazon Copyright comments are missing from files

[swimming-potato]

HI @amirkaws I did address your comment:) please check the PR.

[amirkaws]

Hi @swimming-potato, thank you a lot for that. I think we are still missing copyright comments, we should add Amazon copyright comment on top of each .cs file.

The other thing I believe we should add is a solution file in the example root folder to include both projects juts to be consistent with the. other examples. here is an example for logging https://github.com/aws-powertools/powertools-lambda-dotnet/blob/develop/examples/Logging/PowertoolsLoggingExample.sln

[hjgraca]

Please rename the solution to PowertoolsServerlessApiExample

[hjgraca]

Looks good. Small solution name change

[amirkaws]

LGTM

[hjgraca]

Thank you for a great work @swimming-potato !

[boring-cyborg]

Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!