Merge pull request #1 from palisadoes/main

Initial Commit

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: Bug Report
+about: Create a report to help us improve.
+title: Bug Report
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1.
+2.
+3.
+4.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Actual behavior**
+A clear and concise description of how the code performed w.r.t expectations.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Additional details**
+Add any other context or screenshots about the feature request here.
+
+**Potential internship candidates**
+
+Please read this if you are planning to apply for a Palisadoes Foundation internship 
+- https://github.com/PalisadoesFoundation/switchmap-ng-docs/issues/359
+

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,29 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: Feature Request
+labels: feature request
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. *At this time, we are not making any FOOTER changes.*
+
+**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.
+
+**Approach to be followed (optional)**
+A clear and concise description of approach to be followed.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
+
+**Potential internship candidates**
+
+Please read this if you are planning to apply for a Palisadoes Foundation internship 
+- https://github.com/PalisadoesFoundation/switchmap-ng-docs/issues/359
+

.github/dependabot.yaml

@@ -0,0 +1,18 @@
+# Configuration for automated dependency updates using Dependabot
+version: 2
+updates:
+  # Define the target package ecosystem
+  - package-ecosystem: "npm"
+    # Specify the root directory
+    directory: "/"
+    # Schedule automated updates to run weekly
+    schedule:
+      interval: "weekly"
+    # Labels to apply to Dependabot PRs
+    labels:
+      - "dependencies"
+    # Specify the target branch for PRs
+    target-branch: "main"
+    # Customize commit message prefix
+    commit-message:
+      prefix: "chore(deps):"

.github/pull_request_template.md

@@ -0,0 +1,40 @@
+ <!--
+Thanks for submitting a pull request! Please provide enough information so that others can review your pull request.
+-->
+
+**What kind of change does this PR introduce?**
+
+<!-- E.g. a bugfix, feature, refactoring, etc… -->
+
+**Issue Number:**
+
+Fixes #<!--Add related issue number here.-->
+
+**Did you add tests for your changes?**
+
+<!--Yes or No. Note: Add unit tests or automation tests for your code.-->
+
+**Snapshots/Videos:**
+
+<!--Add snapshots or videos wherever possible.-->
+
+**If relevant, did you update the documentation?**
+
+<!--Add link to Talawa-Docs.-->
+
+**Summary**
+
+<!-- Explain the **motivation** for making this change. What existing problem does the pull request solve? -->
+<!-- Try to link to an open issue for more information. -->
+
+**Does this PR introduce a breaking change?**
+
+<!-- If this PR introduces a breaking change, please describe the impact and a migration path for existing applications. -->
+
+**Other information**
+
+<!--Add extra information about this PR here-->
+
+**Have you read the [contributing guide](https://github.com/PalisadoesFoundation/switchmap-ng-docs/blob/main/CONTRIBUTING.md)?**
+
+<!--Yes or No-->

.github/workflows/authorized-changes-detection.yml

@@ -0,0 +1,36 @@
+##############################################################################
+##############################################################################
+#
+# NOTE!
+#
+# Please read the README.md file in this directory that defines what should 
+# be placed in this file
+#
+##############################################################################
+##############################################################################
+
+name: Checking workflow files
+on:
+  pull_request:
+    paths:
+      - '.github/**'
+      - 'CNAME'
+      - 'static/CNAME'
+      - 'package.json'
+      - 'sidebars.js'
+      - 'sidebar-admin.js'
+      - 'sidebar-mobile-user.js'
+      - 'sidebar-web-user.js'
+      - 'docusaurus.config.js'
+      - 'babel.config.js'
+      - 'CODEOWNERS'
+      - 'LICENSE'
+
+jobs:
+  Checking-for-unauthorized-file-changes:
+    name: Checking for unauthorized file changes
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Unauthorized file modification in PR
+        run: exit 1

.github/workflows/documentation.yml

@@ -0,0 +1,48 @@
+name: Deploy to GitHub Pages
+
+on:
+  pull_request:
+    branches:
+      - main
+      - develop
+  push:
+    branches:
+      - main
+      - develop
+
+jobs:
+  test-deploy:
+    if: github.event_name != 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 22
+          cache: yarn
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+      - name: Test building the website
+        run: yarn build
+
+  deploy:
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 22
+          cache: yarn
+      - uses: webfactory/[email protected]
+        with:
+          ssh-private-key: ${{ secrets.GH_PAGES_DEPLOY }}
+      - name: Deploy to GitHub Pages
+        env:
+          USE_SSH: true
+          GIT_USER: git
+        run: |
+          git config --global user.email "[email protected]"
+          git config --global user.name "gh-actions"
+          yarn install --frozen-lockfile
+          yarn deploy

.github/workflows/issues.yml

@@ -0,0 +1,34 @@
+##############################################################################
+##############################################################################
+#
+# NOTE!
+#
+# Please read the README.md file in this directory that defines what should 
+# be placed in this file
+#
+##############################################################################
+##############################################################################
+
+name: Issues Workflow
+on:
+  issues:
+      types: ['opened']
+jobs:
+  Opened-issue-label:
+    name: Adding Issue Label
+    runs-on: ubuntu-latest
+    steps:
+      - uses: Renato66/[email protected]
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          ignore-comments: true
+          default-labels: '["unapproved"]'
+
+  Issue-Greeting:
+    name: Greeting Message to User
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/first-interaction@v1
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          issue-message: "Congratulations on making your first Issue! :confetti_ball: If you haven't already, check out our [Contributing Guidelines](https://github.com/PalisadoesFoundation/switchmap-ng-docs/blob/main/CONTRIBUTING.md) and [Issue Reporting Guidelines](https://github.com/PalisadoesFoundation/switchmap-ng-docs/blob/main/ISSUE_GUIDELINES.md) to ensure that you are following our guidelines for contributing and making issues."

.github/workflows/pull-request-target.yml

@@ -0,0 +1,67 @@
+##############################################################################
+##############################################################################
+#
+# NOTE!
+#
+# Please read the README.md file in this directory that defines what should 
+# be placed in this file 
+#
+##############################################################################
+##############################################################################
+
+name: PR Target Workflow
+on: 
+  pull_request_target:
+
+jobs:
+  PR-Greeting:
+    name: Pull Request Target
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add the PR Review Policy
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          comment_tag: pr_review_policy
+          message: |
+            ## Our Pull Request Approval Process
+
+            We have these basic policies to make the approval process smoother for our volunteer team.
+
+            ### Testing Your Code
+
+            Please make sure your code passes all tests and there are no merge conflicts. 
+
+            The process helps maintain accurate and well-formatted documentation and is a prerequisite for getting your PR approved. Assigned reviewers regularly review the PR queue and tend to focus on PRs that are passing.
+
+            ### Reviewers
+
+            When your PR has been assigned reviewers contact them to get your code reviewed and approved via:
+
+            1. comments in this PR or
+            1. our slack channel
+
+            #### Reviewing Your Code
+
+            Your reviewer(s) will have the following roles:
+
+            1.  arbitrators of future discussions with other contributors about the validity of your changes
+            2.  point of contact for evaluating the validity of your work
+            3.  person who verifies matching issues by others that should be closed.
+            4.  person who gives general guidance in fixing your tests
+
+            ### CONTRIBUTING.md
+
+            Read our CONTRIBUTING.md file. Most importantly:
+
+            1. PRs with issues not assigned to you will be closed by the reviewer
+            1. Fix the first comment in the PR so that each issue listed automatically closes
+
+            ### Other
+
+            1. :dart: Please be considerate of our volunteers' time. Contacting the person who assigned the reviewers is not advised unless they ask for your input. Do not @ the person who did the assignment otherwise.
+
+      - name: Greeting Message to User
+        uses: actions/first-interaction@v1
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          pr-message: "Congratulations on making your first PR! :confetti_ball: If you haven't already, check out our [Contributing Guidelines](https://github.com/PalisadoesFoundation/switchmap-ng-docs/blob/-/CONTRIBUTING.md) and [PR Reporting Guidelines](https://github.com/PalisadoesFoundation/switchmap-ng-docs/blob/-/PR_GUIDELINES.md) to ensure that you are following our guidelines for contributing and creating PR."

.github/workflows/stale.yml

@@ -0,0 +1,32 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: "0 0 * * *"
+
+permissions:
+  issues: write
+  pull-requests: write  
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/stale@v8
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'This issue did not get any activity in the past 10 days and will be closed in 180 days if no update occurs. Please check if the main branch has fixed it and report again or close the issue.'
+        stale-pr-message: 'This pull request did not get any activity in the past 10 days and will be closed in 180 days if no update occurs. Please verify it has no conflicts with the main branch and rebase if needed. Mention it now if you need help or give permission to other people to finish your work.'
+        close-issue-message: 'This issue did not get any activity in the past 180 days and thus has been closed. Please check if the newest release or main branch has it fixed. Please, create a new issue if the issue is not fixed.'
+        close-pr-message: 'This pull request did not get any activity in the past 180 days and thus has been closed.'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'
+        days-before-stale: 10
+        days-before-close: 180
+        remove-stale-when-updated: true
+        exempt-all-milestones: true
+        exempt-pr-labels: 'bug'
+        exempt-issue-labels: 'bug, wip'
+        operations-per-run: 30