docs: add maintainers and public roadmap (#1167)

* docs: added maintainers handbook page

* docs: added maintainers handbook page

* docs: update mkdocs & nav

* docs: updated toc

* chore: update gh-issue templates

* docs: update notes about languages

* docs: update label

* chore: update stalebot + removed autoassign bot

* chore: update labels in scripts

* docs: updates to maintainers & labels

* fix: label name

* fix: label name

* Update .github/stale.yml

Author: dreamorosi

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,7 +1,7 @@
 name: Bug report
 description: Report a reproducible bug to help us improve
 title: "Bug: TITLE"
-labels: ["bug", "triage"]
+labels: ["type/bug", "triage"]
 body:
   - type: markdown
     attributes:
@@ -76,8 +76,8 @@ body:
   - type: textarea
     id: logs
     attributes:
-      label: Debugging logs
-      description: If available, please share [debugging logs](https://awslabs.github.io/aws-lambda-powertools-python/#debug-mode)
+      label: Execution logs
+      description: If available, please share some logs making sure to remove any sensitive data
       render: Shell
     validations:
       required: false

.github/ISSUE_TEMPLATE/documentation_improvements.yml

@@ -1,7 +1,7 @@
 name: Documentation improvements
 description: Suggest a documentation update to improve everyone's experience
 title: "Docs: TITLE"
-labels: ["documentation", "triage"]
+labels: ["area/documentation", "triage"]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,7 +1,7 @@
 name: Feature request
 description: Suggest an idea for Lambda Powertools
 title: "Feature request: TITLE"
-labels: ["feature-request", "triage"]
+labels: ["type/feature-request", "triage"]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/maintenance.yml

@@ -1,7 +1,7 @@
 name: Maintenance
 description: Suggest an activity to help address tech debt, governance, and anything internal
 title: "Maintenance: TITLE"
-labels: ["internal", "triage"]
+labels: ["type/internal", "triage"]
 body:
   - type: markdown
     attributes:
@@ -32,7 +32,6 @@ body:
         - Automation
         - Governance
         - Tests
-        - Types
         - Tracer
         - Logger
         - Metrics

.github/ISSUE_TEMPLATE/rfc.yml

@@ -1,7 +1,7 @@
 name: Request for Comments (RFC)
 description: Feature design and detailed proposals
 title: "RFC: TITLE"
-labels: ["RFC", "triage"]
+labels: ["type/RFC", "triage"]
 body:
   - type: markdown
     attributes:

.github/PULL_REQUEST_TEMPLATE.md

@@ -32,7 +32,7 @@
 
 ## Checklist
 
-- [ ] [My changes meet the tenets criteria](https://awslabs.github.io/aws-lambda-powertools-python/#tenets)
+- [ ] [My changes meet the tenets criteria](https://awslabs.github.io/aws-lambda-powertools-typescript/#tenets)
 - [ ] I have performed a *self-review* of my own code
 - [ ] I have *commented* my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
 - [ ] I have made corresponding changes to the *documentation*
@@ -41,7 +41,7 @@
 - [ ] The *code coverage* hasn't decreased
 - [ ] I have *added tests* that prove my change is effective and works
 - [ ] New and existing *unit tests pass* locally and in Github Actions
-- [ ] Any *dependent changes have been merged and published* in downstream module
+- [ ] Any *dependent changes have been merged and published*
 - [ ] The PR title follows the [conventional commit semantics](https://github.com/awslabs/aws-lambda-powertools-typescript/blob/main/.github/semantic.yml#L2)
 
 ### Breaking change checklist

.github/auto_assign-issues.yml

@@ -2,28 +2,27 @@ change-template: "* $TITLE (#$NUMBER) by @$AUTHOR"
 categories:
   - title: '⚡ Breaking Changes'
     labels:
-      - 'breaking-change'
+      - 'type/breaking-change'
   - title: '🌟New features and non-breaking changes'
     labels:
-      - 'major'
-      - 'feature'
+      - 'type/feature'
   - title: '🌟 Minor Changes'
     labels:
-      - 'enhancement'
+      - 'type/enhancement'
   - title: '📜 Documentation updates'
     labels:
-      - 'documentation'
+      - 'area/documentation'
   - title: '🐛 Bug and hot fixes'
     labels:
-      - 'bug'
-      - 'fix'
+      - 'type/bug'
+      - 'type/fix'
   - title: '🚒 Deprecations'
     labels:
-      - 'deprecated'
+      - 'type/deprecation'
   - title: '🔧 Maintenance'
     labels:
-      - 'internal'
-      - 'dependencies'
+      - 'type/internal'
+      - 'type/dependencies'
 exclude-labels:
   - 'skip-changelog'
 tag-template: 'v$NEXT_PATCH_VERSION'

.github/release-drafter.yml

@@ -25,7 +25,10 @@ module.exports = Object.freeze({
   "LABEL_BLOCK_REASON": "need-issue",
 
   /** @type {string} */
-  "LABEL_PENDING_RELEASE": "pending-release",
+  "LABEL_PENDING_RELEASE": "status/pending-release",
+  
+  /** @type {string} */
+  "LABEL_RELEASED": "status/completed",
 
   /** @type {string} */
   "HANDLE_MAINTAINERS_TEAM": "@awslabs/aws-lambda-powertools-typescript",

.github/scripts/constants.js

@@ -1,21 +1,19 @@
-const { PR_NUMBER, PR_TITLE, AREAS } = require("./constants");
+const { PR_NUMBER, PR_TITLE } = require("./constants");
 
 module.exports = async ({github, context, core}) => {
-    const FEAT_REGEX = /feat(\((.+)\))?(:.+)/
     const BUG_REGEX = /(fix|bug)(\((.+)\))?(:.+)/
+    const FEAT_REFACTOR_REGEX = /(feat|refactor)(\((.+)\))?(:.+)/
     const DOCS_REGEX = /(docs|doc)(\((.+)\))?(:.+)/
     const CHORE_REGEX = /(chore)(\((.+)\))?(:.+)/
     const DEPRECATED_REGEX = /(deprecated)(\((.+)\))?(:.+)/
-    const REFACTOR_REGEX = /(refactor)(\((.+)\))?(:.+)/
-
+    
     const labels = {
-        "feature": FEAT_REGEX,
-        "bug": BUG_REGEX,
-        "documentation": DOCS_REGEX,
-        "internal": CHORE_REGEX,
-        "enhancement": REFACTOR_REGEX,
-        "deprecated": DEPRECATED_REGEX,
-    };
+        "type/feature": FEAT_REFACTOR_REGEX,
+        "type/bug": BUG_REGEX,
+        "area/documentation": DOCS_REGEX,
+        "type/internal": CHORE_REGEX,
+        "type/deprecation": DEPRECATED_REGEX,
+    }
 
     // Maintenance: We should keep track of modified PRs in case their titles change
     let miss = 0;
@@ -33,19 +31,6 @@ module.exports = async ({github, context, core}) => {
                     labels: [label]
                 });
 
-                const area = matches[2]; // second capture group contains the area
-                if (AREAS.indexOf(area) > -1) {
-                    core.info(`Auto-labeling PR ${PR_NUMBER} with area ${area}`);
-                    await github.rest.issues.addLabels({
-                        issue_number: PR_NUMBER,
-                        owner: context.repo.owner,
-                        repo: context.repo.repo,
-                        labels: [`area/${area}`],
-                    });
-                } else {
-                    core.debug(`'${PR_TITLE}' didn't match any known area.`);
-                }
-
                 return;
             } else {
                 core.debug(`'${PR_TITLE}' didn't match '${label}' semantic.`);