Merge branch 'main' of https://github.com/nishant0708/codeharborhub.github.io

Author: nishant0708

.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/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