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

Author: katarianikita2003

.env.example

@@ -2,4 +2,4 @@ BASE_URL =
 ALGOLIA_API_KEY = 
 ALGOLIA_APP_ID =
 GTM_ID = 
-GA_ID = 
+GA_ID =

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

@@ -0,0 +1,21 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # Using npm for Docusaurus
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/" 
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "docker"
+    directory: "/" 
+    schedule:
+      interval: "weekly"

.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/autocomment-iss-close.yml

@@ -1,29 +1,29 @@
-name: Comment on Issue Close
-
-on:
-  issues:
-    types: [closed]
-
-jobs:
-  greet-on-close:
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-    steps:
-      - name: Greet User
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const issue = context.payload.issue;
-            const issueCreator = issue.user.login;
-            const issueNumber = issue.number;
-
-            const greetingMessage = `Hello @${issueCreator}! Your issue #${issueNumber} has been closed. Thank you for your contribution!`;
-
-            github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: issueNumber,
-              body: greetingMessage
+name: Comment on Issue Close
+
+on:
+  issues:
+    types: [closed]
+
+jobs:
+  greet-on-close:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Greet User
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issue = context.payload.issue;
+            const issueCreator = issue.user.login;
+            const issueNumber = issue.number;
+
+            const greetingMessage = `Hello @${issueCreator}! Your issue #${issueNumber} has been closed. Thank you for your contribution!`;
+
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              body: greetingMessage
             });

.github/workflows/close-old-issue.yml

@@ -1,37 +1,37 @@
-name: Close Old Issues
-on:
-  schedule:
-    - cron: "0 0 * * *"
-
-jobs:
-  close-issues:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Close Old Issues
-        run: |
-          open_issues=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-            "https://api.github.com/repos/${{ github.repository }}/issues?state=open" \
-            | jq -r '.[] | .number')
-          for issue in $open_issues; do
-            # Get the last updated timestamp of the issue
-            last_updated=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-              "https://api.github.com/repos/${{ github.repository }}/issues/$issue" \
-              | jq -r '.updated_at')
-            days_since_update=$(( ( $(date +%s) - $(date -d "$last_updated" +%s) ) / 86400 ))
-            if [ $days_since_update -gt 30 ]; then
-              curl -s -X PATCH -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-                -H "Accept: application/vnd.github.v3+json" \
-                -d '{"state":"closed"}' \
-                "https://api.github.com/repos/${{ github.repository }}/issues/$issue"
-              
-              # Add a comment explaining when the issue will be closed
-              curl -s -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-                -H "Accept: application/vnd.github.v3+json" \
-                -d '{"body":"This issue has been automatically closed because it has been inactive for more than 30 days. If you believe this is still relevant, feel free to reopen it or create a new one. Thank you!"}' \
-                "https://api.github.com/repos/${{ github.repository }}/issues/$issue/comments"
-            fi
+name: Close Old Issues
+on:
+  schedule:
+    - cron: "0 0 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Close Old Issues
+        run: |
+          open_issues=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+            "https://api.github.com/repos/${{ github.repository }}/issues?state=open" \
+            | jq -r '.[] | .number')
+          for issue in $open_issues; do
+            # Get the last updated timestamp of the issue
+            last_updated=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+              "https://api.github.com/repos/${{ github.repository }}/issues/$issue" \
+              | jq -r '.updated_at')
+            days_since_update=$(( ( $(date +%s) - $(date -d "$last_updated" +%s) ) / 86400 ))
+            if [ $days_since_update -gt 30 ]; then
+              curl -s -X PATCH -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+                -H "Accept: application/vnd.github.v3+json" \
+                -d '{"state":"closed"}' \
+                "https://api.github.com/repos/${{ github.repository }}/issues/$issue"
+              
+              # Add a comment explaining when the issue will be closed
+              curl -s -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+                -H "Accept: application/vnd.github.v3+json" \
+                -d '{"body":"This issue has been automatically closed because it has been inactive for more than 30 days. If you believe this is still relevant, feel free to reopen it or create a new one. Thank you!"}' \
+                "https://api.github.com/repos/${{ github.repository }}/issues/$issue/comments"
+            fi
           done

.github/workflows/close-old-pr.yml

@@ -1,34 +1,34 @@
-name: Close Stale PRs
-
-on:
-  schedule:
-    - cron: '0 0 * * *' # Runs daily at midnight
-  pull_request:
-    types:
-      - opened
-      - reopened
-      - synchronize
-
-permissions:
-  pull-requests: write
-  issues: write
-
-jobs:
-  close_stale_prs:
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-  
-    steps:
-    - uses: actions/stale@v9
-      with:
-        repo-token: ${{ secrets.GITHUB_TOKEN }}
-        stale-pr-message: 'This PR has been automatically closed due to inactivity from the owner for 15 days.'
-        days-before-pr-stale: 15
-        days-before-pr-close: 0
-        exempt-pr-author: false
-        exempt-pr-labels: ''
-        only-labels: ''
-        operations-per-run: 30
-        remove-stale-when-updated: true
+name: Close Stale PRs
+
+on:
+  schedule:
+    - cron: '0 0 * * *' # Runs daily at midnight
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+
+permissions:
+  pull-requests: write
+  issues: write
+
+jobs:
+  close_stale_prs:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+  
+    steps:
+    - uses: actions/stale@v9
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-pr-message: 'This PR has been automatically closed due to inactivity from the owner for 15 days.'
+        days-before-pr-stale: 15
+        days-before-pr-close: 0
+        exempt-pr-author: false
+        exempt-pr-labels: ''
+        only-labels: ''
+        operations-per-run: 30
+        remove-stale-when-updated: true
         debug-only: false