build: First merge to main (#109)

First merge of alpha version to main from develop

Co-authored-by: Stephen Liedig <[email protected]>
Co-authored-by: Matt Simpson <[email protected]>
Co-authored-by: Peter Grman <[email protected]>
Co-authored-by: Tiago Barbosa <[email protected]>
Co-authored-by: Amir Khairalomoum <[email protected]>

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug, triage
+assignees: ''
+
+---
+
+<!--- Provide a general summary of the issue in the Title above -->
+<!--- How has this issue affected you? What are you trying to accomplish? -->
+
+**What were you trying to accomplish?**
+
+## Expected Behavior
+<!--- If you're describing a bug, tell us what should happen -->
+<!--- If you're suggesting a change/improvement, tell us how it should work -->
+
+## Current Behavior
+<!--- If describing a bug, tell us what happens instead of the expected behavior -->
+<!--- If suggesting a change/improvement, explain the difference from current behavior -->
+
+## Possible Solution
+<!--- Not obligatory, but suggest a fix/reason for the bug, -->
+<!--- or ideas how to implement the addition or change -->
+
+## Steps to Reproduce (for bugs)
+<!--- Provide a link to a live example, or an unambiguous set of steps to -->
+<!--- reproduce this bug. Include code to reproduce, if relevant -->
+1.
+2.
+3.
+4.
+
+## Environment
+
+* **Powertools version used**:
+* **AWS Lambda function runtime:**
+* **Debugging logs**
+
+```csharp
+# paste logs here
+```

.github/ISSUE_TEMPLATE/documentation-improvements.md

@@ -0,0 +1,17 @@
+---
+name: Documentation improvements
+about: Suggest a documentation update
+title: ''
+labels: documentation
+assignees: ''
+
+---
+
+**What were you initially searching for in the docs?**
+<!-- Please help us understand how you looked for information that was either not available or unclear -->
+
+**Is this related to an existing part of the documentation? Please share a link**
+
+**Describe how we could make it clearer**
+
+**If you have a proposed update, please share it here**

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: feature-request, triage
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
+
+**Describe the solution you'd like**
+<!-- A clear and concise description of what you want to happen. -->
+
+**Describe alternatives you've considered**
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
+
+**Additional context**
+<!-- Add any other context or screenshots about the feature request here. -->

.github/ISSUE_TEMPLATE/rfc.md

@@ -0,0 +1,62 @@
+---
+name: RFC
+about: Feature design and proposals
+title: 'RFC: '
+labels: RFC, triage
+assignees: ''
+approved by: ''
+---
+
+## Key information
+
+* RFC PR: (leave this empty)
+* Related issue(s), if known:
+* Area: (i.e. Tracer, Metrics, Logger, etc.)
+* Meet [tenets](https://awslabs.github.io/aws-lambda-powertools-dotnet/#tenets): (Yes/no)
+* Approved by: ''
+* Reviewed by: ''
+
+## Summary
+[summary]: #summary
+
+> One paragraph explanation of the feature.
+
+## Motivation
+[motivation]: #motivation
+
+> Why are we doing this? What use cases does it support? What is the expected outcome?
+
+## Proposal
+[proposal]: #proposal
+
+> This is the bulk of the RFC.
+
+> Explain the design in enough detail for somebody familiar with Powertools to understand it, and for somebody familiar with the implementation to implement it.
+
+**If this feature should be available in other runtimes (e.g. Java, Typescript), how would this look like to ensure consistency?**
+
+## User Experience
+
+**How would customers use it?**
+
+**Any configuration or corner cases you'd expect?**
+
+**Demonstration of before and after on how the experience will be better**
+
+## Drawbacks
+[drawbacks]: #drawbacks
+
+> Why should we *not* do this?
+
+> Do we need additional dependencies? Impact performance/package size?
+
+## Rationale and alternatives
+[rationale-and-alternatives]: #rationale-and-alternatives
+
+* **What other designs have been considered? Why not them?**
+* **What is the impact of not doing this?**
+
+## Unresolved questions
+[unresolved-questions]: #unresolved-questions
+
+> Optional, stash area for topics that need further development e.g. TBD

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+**Issue #, if available:**
+
+## Description of changes:
+
+<!--- One or two sentences as a summary of what's being changed -->
+
+**Checklist**
+
+<!--- Leave unchecked if your change doesn't seem to apply --> 
+
+* [ ] [Meet tenets criteria](https://awslabs.github.io/aws-lambda-powertools-dotnet/#tenets)
+* [ ] Update tests
+* [ ] Update docs
+* [ ] PR title follows [conventional commit semantics](https://github.com/awslabs/aws-lambda-powertools-dotnet/blob/develop/.github/semantic.yml)
+
+## Breaking change checklist
+
+<!--- Ignore if it's not a breaking change -->
+
+**RFC issue #**:
+
+* [ ] Migration process documented
+* [ ] Implement warnings (if it can live side by side)
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

.github/auto_assign-issues.yml

@@ -0,0 +1,8 @@
+addAssignees: true
+
+# The list of users to assign to new issues.
+# If empty or not provided, the repository owner is assigned
+assignees:
+  - t1agob
+  - sliedig
+  - amirkaws

.github/boring-cyborg.yml

@@ -0,0 +1,45 @@
+##### Labeler ##########################################################################################################
+labelPRBasedOnFilePath:
+  area/logger:
+    - libraries/src/AWS.Lambda.Powertools.Logging/*
+    - libraries/src/AWS.Lambda.Powertools.Logging/**/*
+  area/tracer:
+    - libraries/src/AWS.Lambda.Powertools.Tracing/*
+    - libraries/src/AWS.Lambda.Powertools.Tracing/**/*
+  area/metrics:
+    - libraries/src/AWS.Lambda.Powertools.Metrics/*
+    - libraries/src/AWS.Lambda.Powertools.Metrics/**/*
+
+  documentation:
+    - docs/*
+    - docs/**/*
+    - mkdocs.yml
+
+  internal:
+    - .github/*
+    - .github/**/*
+    - .chglog/*
+    - .flake8
+    - .gitignore
+    - .pre-commit-config.yaml
+    - Makefile
+    - CONTRIBUTING.md
+    - CODE_OF_CONDUCT.md
+    - LICENSE
+
+  tests:
+    - libraries/tests/*
+    - libraries/tests/**/*
+
+
+##### Greetings ########################################################################################################
+firstPRWelcomeComment: >
+  Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.
+
+# Comment to be posted to congratulate user on their first merged PR
+firstPRMergeComment: >
+  Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!
+
+# Comment to be posted to on first time issues
+firstIssueWelcomeComment: >
+  Thanks for opening your first issue here! We'll come back to you as soon as we can.

.github/release-drafter.yml

@@ -0,0 +1,39 @@
+change-template: "* $TITLE (#$NUMBER) by @$AUTHOR"
+categories:
+  - title: '⚡ Breaking Changes'
+    labels:
+      - 'breaking-change'
+  - title: '🌟New features and non-breaking changes'
+    labels:
+      - 'major'
+      - 'feature'
+  - title: '🌟 Minor Changes'
+    labels:
+      - 'enhancement'
+  - title: '📜 Documentation updates'
+    labels:
+      - 'documentation'
+  - title: '🐛 Bug and hot fixes'
+    labels:
+      - 'bug'
+      - 'fix'
+  - title: '🚒 Deprecations'
+    labels:
+      - 'deprecated'
+  - title: '🔧 Maintenance'
+    labels:
+      - 'internal'
+      - 'dependencies'
+exclude-labels:
+  - 'skip-changelog'
+tag-template: 'v$NEXT_PATCH_VERSION'
+template: |
+  ## Changes
+
+  **[Human readable summary of changes]**
+
+  $CHANGES
+
+  ## This release was made possible by the following contributors:
+
+  $CONTRIBUTORS

.github/semantic.yml

@@ -0,0 +1,19 @@
+# conventional commit types: https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json
+types:
+  - feat
+  - fix
+  - docs
+  - style
+  - refactor
+  - perf
+  - test
+  - build
+  - ci
+  - chore
+  - revert
+  - improv
+
+# Always validate the PR title
+# and ignore the commits to lower the entry bar for contribution
+# while titles make up the Release notes to ease maintenance overhead
+titleOnly: true

.github/stale.yml

@@ -0,0 +1,17 @@
+only: issues
+daysUntilStale: 30
+daysUntilClose: 7
+exemptLabels:
+  - bug
+  - documentation
+  - enhancement
+  - feature-request
+  - RFC
+staleLabel: pending-close-response-required
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+closeComment: >
+  This issue has been automatically closed because of inactivity.
+  Please open a new issue if you are still encountering problems.

.github/workflows/build.yml

@@ -0,0 +1,37 @@
+name: Build .NET
+
+on:
+  push:
+    branches: [ develop, main ]
+  pull_request:
+    branches: [ develop, main ]
+
+defaults:
+  run:
+    working-directory: ./libraries
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Setup .NET 6.0
+      uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: 6.0.x
+    - name: Install solution dependencies
+      run: dotnet restore
+    - name: Build
+      run: dotnet build --configuration Release --no-restore
+    - name: Test & Code Coverage
+      run: dotnet test --collect:"XPlat Code Coverage" -r ./codecov --no-restore --verbosity normal
+    - name: Codecov
+      uses: codecov/[email protected]
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        flags: unittests
+        fail_ci_if_error: true
+        name: codecov-lambda-powertools-dotnet
+        verbose: true
+        directory: ./libraries/codecov

.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Set up Python
+        uses: actions/[email protected]
+        with:
+          python-version: "3.8"
+      - name: Capture branch and tag
+        id: branch_name
+        run: |
+          echo "SOURCE_BRANCH=${GITHUB_REF#refs/heads/}" >> $GITHUB_ENV
+          echo "SOURCE_TAG=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+      - name: Build docs website
+        run: make build-docs-website
+      - name: Deploy all docs
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+  apidocs:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Configure and build api docs generator
+        run: |
+          brew install -f docfx --skip-cask-deps --ignore-dependencies
+          docfx apidocs/docfx.json
+      - name: Release API docs to latest
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./apidocs/_site
+          keep_files: true
+          destination_dir: api