Merge branch 'main' into sortcolor

Author: ajay-dhangar

.github/ISSUE_TEMPLATE/documentation.yml

@@ -11,6 +11,7 @@ body:
       options:
         - label: I have searched the existing issues
           required: true
+
   - type: textarea
     id: issue-description
     attributes:
@@ -19,6 +20,7 @@ body:
       placeholder: Describe the improvement or correction you'd like to see in the documentation.
     validations:
       required: true
+
   - type: textarea
     id: suggested-change
     attributes:
@@ -27,14 +29,16 @@ body:
       placeholder: Explain how the documentation should be updated or corrected.
     validations:
       required: true
+
   - type: textarea
     id: rationale
     attributes:
       label: Rationale
       description: Why is this documentation update necessary or beneficial?
       placeholder: Explain the importance or reasoning behind the suggested change.
     validations:
-      required: False
+      required: false
+
   - type: dropdown
     id: urgency
     attributes:
@@ -47,14 +51,34 @@ body:
       default: 0
     validations:
       required: true
+
   - type: checkboxes
     id: terms
     attributes:
-      label: Record
+      label: Acknowledgements
+      description: Ensure you have read and agree to the project's guidelines.
       options:
-        - label: "I have read the Contributing Guidelines"
+        - label: I have read the Contributing Guidelines
           required: true
-        - label: "I'm a GSSOC'24 contributor"
+        - label: I'm a GSSOC'24 contributor
           required: false
-        - label: "I have starred the repository"
+        - label: I have starred the repository
+          required: true
+        - label: I have read and followed the Contribution Guidelines
+          required: true
+        - label: I have followed the code style guidelines of this project
+          required: true
+        - label: I have checked for any existing open issues that my pull request may address
+          required: true
+        - label: I have ensured that my changes do not break any existing functionality
+          required: true
+        - label: Each contributor is allowed to create a maximum of 4 issues per day. This helps us manage and address issues efficiently
+          required: true
+        - label: I have read the resources for guidance listed below
+          required: true
+        - label: I have not used AI-generated content (e.g., ChatGPT, other AI tools)
+          required: true
+        - label: I have not used content from existing sites (e.g., text, images)
+          required: true
+        - label: I have followed all security rules and only shared trusted resources
           required: true

.github/pull_request_template.md

@@ -11,6 +11,7 @@
 - [ ] Bug fix
 - [ ] Feature enhancement
 - [ ] Documentation update
+- [ ] Security enhancement
 - [ ] Other (specify): _______________
 
 ## Screenshots / Videos (if applicable)
@@ -23,24 +24,63 @@
 - [ ] I have tested the changes thoroughly before submitting this pull request.
 - [ ] I have provided relevant issue numbers, screenshots, and videos after making the changes.
 - [ ] I have commented my code, particularly in hard-to-understand areas.
-<!-- [X] - put a cross/X inside [] to check the box -->
+- [ ] I have followed the code style guidelines of this project.
+- [ ] I have checked for any existing open issues that my pull request may address.
+- [ ] I have ensured that my changes do not break any existing functionality.
+- [ ] Each contributor is allowed to create a maximum of 4 issues per day. This helps us manage and address issues efficiently.
+- [ ] I have read the resources for guidance listed below.
+- [ ] I have followed security best practices in my code changes.
 
 ## Additional Context
 
 [Include any additional information or context that might be helpful for reviewers.]
 
 ## Resources for Guidance
 
-Here are some resources that may be helpful as you contribute to CodeHarborHub:
-- [Code Harbor Hub Community Features](https://www.codeharborhub.live/community/features)
-- [Docusaurus Documentation](https://docusaurus.io/docs/create-doc)
-- [React.js Documentation](https://legacy.reactjs.org/docs/getting-started.html)
-- [Markdown Guide](https://www.markdownguide.org/)
-- [MDX Documentation](https://mdxjs.com/docs/)
-- [Mermaid Documentation](https://mermaid.js.org/)
+Please read the following resources before submitting your contribution:
+
+- [ ] [Code Harbor Hub Community Features](https://www.codeharborhub.live/community/features)
+- [ ] [Docusaurus Documentation](https://docusaurus.io/docs/create-doc)
+- [ ] [React.js Documentation](https://legacy.reactjs.org/docs/getting-started.html)
+- [ ] [Markdown Guide](https://www.markdownguide.org/)
+- [ ] [MDX Documentation](https://mdxjs.com/docs/)
+- [ ] [Mermaid Documentation](https://mermaid.js.org/)
 
 **Resources for DSA Features on Our Site:**
 
-- Tabs: [Switch Languages](https://www.codeharborhub.live/community/features#multi-language-support-code-blocks)
-- [Line Numbering](https://www.codeharborhub.live/community/features#line-numbering)
-- [Math Equations](https://www.codeharborhub.live/community/features#math-equations-with-katex)
+- [ ] [Tabs: Switch Languages](https://www.codeharborhub.live/community/features#multi-language-support-code-blocks)
+- [ ] [Line Numbering](https://www.codeharborhub.live/community/features#line-numbering)
+- [ ] [Math Equations](https://www.codeharborhub.live/community/features#math-equations-with-katex) 
+
+## Contribution Guidelines
+
+Thank you for considering contributing to our project! To ensure smooth collaboration and effective contribution management, please adhere to the following guidelines:
+
+### Issue Creation
+
+1. **Limit on Issues:**
+   - Each contributor is allowed to create a maximum of **4 issues per day**. This helps us manage and address issues efficiently.
+
+### Contribution Levels
+
+2. **Basic Contributions:**
+   - This project is primarily focused on documentation. Most of the setup has been completed, so contributors will generally need to work on basic code tasks, such as writing tests.
+   - For these tasks, issues will be assigned the **level1** label.
+
+3. **Acknowledging Hard Work:**
+   - If a contributor puts in significant effort on a task, the issue will be upgraded to **level2**. This is our way of recognizing and appreciating extra effort.
+
+4. **Feature Additions and Component Work:**
+   - Contributors working on new features or components using JSX/TSX will be assigned a level based on the complexity and quality of their work.
+   - The more complex and valuable the contribution, the higher the level assigned.
+
+### Level Definitions
+
+- **Level1:**
+  - Tasks are straightforward, such as fixing minor bugs, writing tests, or making simple documentation updates.
+- **Level2:**
+  - Tasks require more effort, such as addressing complex bugs, improving existing features, or making substantial documentation improvements.
+- **Level3:**
+  - Tasks are highly complex and involve significant new feature development, major refactoring, or extensive contributions to the project’s core components.
+
+We look forward to your contributions and appreciate your effort in helping us improve the project!

.github/workflows/greetings.yml

@@ -1,20 +1,61 @@
-name: Greetings
+name: 'Greetings'
 
-on: [pull_request_target, issues]
+on:
+  issues:
+    types: [opened]
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  issues: write
+  pull-requests: write
 
 jobs:
-  greeting:
+  welcome:
     runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: write
+
     steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
       - name: Greet first-time contributors
         id: greet
         uses: actions/first-interaction@v1
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           issue-message: |
-            Hi there! 👋 Thank you for opening your first issue on CodeHarborHub. We're excited to hear your thoughts and help you out. Please provide as much detail as you can so we can assist you effectively.
+            Hi there! 👋 Thank you for opening your issue on CodeHarborHub. We're excited to hear your thoughts and help you out. You've raised a great topic! Please provide as much detail as you can so we can assist you effectively. Welcome aboard!
           pr-message: |
-            Hi there! 👋 Thank you for submitting your first pull request to CodeHarborHub. We appreciate your contribution! Our team will review it soon. If you have any questions or need further assistance, feel free to reach out.
+            Hi there! 👋 Thank you for submitting your pull request to CodeHarborHub. Great job on the contribution! 🎉 We appreciate your efforts and our team will review it soon. If you have any questions or need further assistance, feel free to reach out. Keep up the great work!
+
+      - name: Assign issue or pull request to team member
+        if: github.event_name == 'issues' || github.event_name == 'pull_request_target'
+        run: |
+          ISSUE_NUMBER=${{ github.event.issue.number || github.event.pull_request.number }}
+          curl -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+          -d '{"assignees":["team-member"]}' \
+          "https://api.github.com/repos/${{ github.repository }}/issues/${ISSUE_NUMBER}"
+
+      - name: Welcome message for community contributors
+        if: github.event_name == 'issues' || github.event_name == 'pull_request_target'
+        uses: EddieHubCommunity/gh-action-community/src/welcome@main
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          issue-message: "Hi @${{ github.actor }}! Thanks for opening this issue. We appreciate your contribution to this open-source project. Your input is valuable and we aim to respond or assign your issue as soon as possible. Thanks again!"
+          pr-message: "Great job, @${{ github.actor }}! 🎉 Thank you for submitting your pull request to CodeHarborHub. We appreciate your contribution and enthusiasm! Our team will review it soon. If you have any questions or need further assistance, feel free to reach out. Thanks for contributing!"
+
+      - name: Label first-time issues
+        if: github.event_name == 'issues'
+        run: |
+          ISSUE_NUMBER=${{ github.event.issue.number }}
+          curl -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+          -d '{"labels":["CodeHarborHub - Thanks for creating an issue!"]}' \
+          "https://api.github.com/repos/${{ github.repository }}/issues/${ISSUE_NUMBER}"
+
+      - name: Label first-time pull requests
+        if: github.event_name == 'pull_request_target'
+        run: |
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          curl -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+          -d '{"labels":["CodeHarborHub - Thanks for creating a pull request!"]}' \
+          "https://api.github.com/repos/${{ github.repository }}/issues/${PR_NUMBER}"

.github/workflows/issue_creation_workflow.yml

@@ -5,7 +5,7 @@ on:
     types: [opened]
 
 jobs:
-  check-contributor-issues:
+  check-issue:
     runs-on: ubuntu-latest
 
     steps:
@@ -17,24 +17,33 @@ jobs:
         with:
           node-version: '14'
 
-      - name: Retrieve Contributors
+      - name: Retrieve Contributor's Open Issues
+        id: retrieve-issues
         run: |
-          CONTRIBUTORS=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" https://api.github.com/repos/${{ github.repository }}/contributors | jq -r '.[].login')
-          echo "::set-output name=contributors::$CONTRIBUTORS"
-
-      - name: Count Open Issues for Each Contributor
-        id: count-issues
-        run: |
-          for contributor in ${{ steps.retrieve-contributors.outputs.contributors }}; do
-            ISSUE_COUNT=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" "https://api.github.com/search/issues?q=is:open+author:${contributor}+repo:${{ github.repository }}" | jq -r '.total_count')
-            echo "::set-output name=${contributor}_issue_count::$ISSUE_COUNT"
-          done
+          ISSUE_COUNT=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" "https://api.github.com/search/issues?q=is:open+author:${{ github.event.issue.user.login }}+repo:${{ github.repository }}" | jq -r '.total_count')
+          echo "::set-output name=issue_count::$ISSUE_COUNT"
 
       - name: Check Contributor's Open Issues Count
         run: |
-          contributor=${{ github.event.issue.user.login }}
-          issue_count=${{ steps.count-issues.outputs["${contributor}_issue_count"] }}
+          issue_count=${{ steps.retrieve-issues.outputs.issue_count }}
           if [ "$issue_count" -ge 4 ]; then
-            echo "Contributor $contributor has $issue_count open issues. Please complete your existing open issues before creating a new one."
+            echo "Contributor ${{ github.event.issue.user.login }} has $issue_count open issues. Please complete your existing open issues before creating a new one."
+            exit 1
+          fi
+
+      - name: Validate Issue Content
+        id: validate-issue
+        run: |
+          issue_body="${{ github.event.issue.body }}"
+          if [[ "$issue_body" == *"AI-generated content"* ]] || [[ "$issue_body" == *"existing sites"* ]]; then
+            echo "Issue body contains disallowed content."
+            exit 1
+          fi
+
+      - name: Check for Security and Trust
+        run: |
+          issue_body="${{ github.event.issue.body }}"
+          if [[ "$issue_body" != *"security"* ]] || [[ "$issue_body" != *"trust"* ]]; then
+            echo "Issue does not mention security or trust."
             exit 1
           fi

.github/workflows/pr_creation_workflow.yml

@@ -0,0 +1,66 @@
+name: PR Creation Workflow
+
+on:
+  pull_request:
+    types: [opened, edited]
+
+jobs:
+  check-pr:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '14'
+
+      - name: Validate PR Description
+        id: validate-pr
+        run: |
+          pr_body="${{ github.event.pull_request.body }}"
+          required_checkboxes=(
+            "I have performed a self-review of my code."
+            "I have read and followed the Contribution Guidelines."
+            "I have tested the changes thoroughly before submitting this pull request."
+            "I have provided relevant issue numbers, screenshots, and videos after making the changes."
+            "I have commented my code, particularly in hard-to-understand areas."
+            "I have followed the code style guidelines of this project."
+            "I have checked for any existing open issues that my pull request may address."
+            "I have ensured that my changes do not break any existing functionality."
+            "Each contributor is allowed to create a maximum of 4 issues per day. This helps us manage and address issues efficiently."
+            "I have read the resources for guidance listed below."
+            "I have not used AI-generated content (e.g., ChatGPT, other AI tools)."
+            "I have not used content from existing sites (e.g., text, images)."
+            "I have followed all security rules and only shared trusted resources."
+          )
+          for checkbox in "${required_checkboxes[@]}"; do
+            if [[ "$pr_body" != *"$checkbox"* ]]; then
+              echo "Missing required checkbox: $checkbox"
+              exit 1
+            fi
+          done
+
+      - name: Retrieve Contributors
+        run: |
+          CONTRIBUTORS=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" https://api.github.com/repos/${{ github.repository }}/contributors | jq -r '.[].login')
+          echo "::set-output name=contributors::$CONTRIBUTORS"
+
+      - name: Count Open Issues for Each Contributor
+        id: count-issues
+        run: |
+          for contributor in ${{ steps.retrieve-contributors.outputs.contributors }}; do
+            ISSUE_COUNT=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" "https://api.github.com/search/issues?q=is:open+author:${contributor}+repo:${{ github.repository }}" | jq -r '.total_count')
+            echo "::set-output name=${contributor}_issue_count::$ISSUE_COUNT"
+          done
+
+      - name: Check Contributor's Open Issues Count
+        run: |
+          contributor=${{ github.event.pull_request.user.login }}
+          issue_count=${{ steps.count-issues.outputs["${contributor}_issue_count"] }}
+          if [ "$issue_count" -ge 4 ]; then
+            echo "Contributor $contributor has $issue_count open issues. Please complete your existing open issues before creating a new one."
+            exit 1
+          fi