[pull] master from veggiemonk:master

.github/ISSUE_TEMPLATE/add-a-project.md

@@ -0,0 +1,18 @@
+---
+name: Add a project
+about: Add a new project to the list
+title: add [PROJECT_NAME]
+labels: pending-evaluation
+assignees: ''
+
+---
+
+Repository link:
+Description:
+Author:
+
+Or directly write it:
+
+```markdown
+[REPO](https://github.com/AUTHOR/REPO) - DESCRIPTION. By [@AUTHOR](https://github.com/AUTHOR)
+```

.github/MAINTENANCE.md

@@ -0,0 +1,116 @@
+# 🔧 Maintenance Guide for Awesome Docker
+
+This guide helps maintainers keep the awesome-docker list up-to-date and high-quality.
+
+## 🤖 Automated Systems
+
+### Weekly Health Reports
+- **What**: Checks all GitHub repositories for activity, archived status, and maintenance
+- **When**: Every Monday at 9 AM UTC
+- **Where**: Creates/updates a GitHub issue with label `health-report`
+- **Action**: Review the report and mark abandoned projects with `:skull:`
+
+### Broken Links Detection  
+- **What**: Tests all links in README.md for availability
+- **When**: Every Saturday at 2 AM UTC + on every PR
+- **Where**: Creates/updates a GitHub issue with label `broken-links`
+- **Action**: Fix or remove broken links, or add to exclusion list
+
+### PR Validation
+- **What**: Checks for duplicate links and basic validation
+- **When**: On every pull request
+- **Action**: Automated - contributors see results immediately
+
+## 📋 Manual Maintenance Tasks
+
+### Monthly Review (First Monday of the month)
+1. Check health report issue for archived/stale projects
+2. Mark archived projects with `:skull:` in README.md
+3. Review projects with 2+ years of inactivity
+4. Remove projects that are truly abandoned/broken
+
+### Quarterly Deep Dive (Every 3 months)
+1. Run: `npm run health-check` for detailed report
+2. Review project categories - are they still relevant?
+3. Check for popular new Docker tools to add
+4. Update documentation links if newer versions exist
+
+### Annual Cleanup (January)
+1. Remove all `:skull:` projects older than 1 year
+2. Review CONTRIBUTING.md guidelines
+3. Update year references in documentation
+4. Check Node.js version requirements
+
+## 🛠️ Maintenance Commands
+
+```bash
+# Test all links (requires GITHUB_TOKEN)
+npm test
+
+# Test PR changes only
+npm run test-pr
+
+# Generate health report (requires GITHUB_TOKEN)
+npm run health-check
+
+# Build the website
+npm run build
+
+# Update dependencies
+npm update
+```
+
+## 📊 Quality Standards
+
+### Adding New Projects
+- Must have clear documentation (README with install/usage)
+- Should have activity within last 18 months
+- GitHub project preferred over website links
+- Must be Docker/container-related
+
+### Marking Projects as Abandoned
+Use `:skull:` emoji when:
+- Repository is archived on GitHub
+- No commits for 2+ years
+- Project explicitly states it's deprecated
+- Maintainer confirms abandonment
+
+### Removing Projects
+Only remove (don't just mark `:skull:`):
+- Broken/404 links that can't be fixed
+- Duplicate entries
+- Spam or malicious projects
+- Projects that never met quality standards
+
+## 🚨 Emergency Procedures
+
+### Critical Broken Links
+If important resources are down:
+1. Check if they moved (update URL)
+2. Search for alternatives
+3. Check Internet Archive for mirrors
+4. Temporarily comment out until resolved
+
+### Spam Pull Requests
+1. Close immediately
+2. Mark as spam
+3. Block user if repeated offense
+4. Don't engage in comments
+
+## 📈 Metrics to Track
+
+- Total projects: ~731 GitHub repos
+- Health status: aim for <5% archived
+- Link availability: aim for >98% working
+- PR merge time: aim for <7 days
+- Weekly contributor engagement
+
+## 🤝 Getting Help
+
+- Open a discussion in GitHub Discussions
+- Check AGENTS.md for AI assistant guidelines
+- Review CONTRIBUTING.md for contributor info
+
+---
+
+*Last updated: 2025-10-01*

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,18 +2,16 @@
 
 <!-- **Remember that entries are ordered alphabetically** -->
 
-<!-- 
-TLDR: 
- * all entries sorted alphabetically,  
+# TLDR
+ * all entries sorted alphabetically (from A to Z),
  * If paying service add :heavy_dollar_sign:
  * If WIP add :construction: 
  * clear and short description of the project
  * project MUST have: How to setup/install
  * project MUST have: How to use (examples)
  * we can help you get there :)
--->
 
-# Quality Standards
+## Quality Standards
 
 Note that we can help you achieve those standards, just try your best and be brave.
 We'll guide you to the best of our abilities.
@@ -48,4 +46,3 @@ But usually, we are pretty relaxed people, so just come and say hi, we'll figure
 
 Please contribute links to packages/projects you have used or are familiar with. This will help ensure high-quality entries.
 
-#### Your commit message will be a [tweet](https://twitter.com/awesome_docker) so write a [good commit message](https://chris.beams.io/posts/git-commit/), keep that in mind :)

.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  # Enable version updates for npm
+  - package-ecosystem: "npm"
+    # Look for `package.json` and `lock` files in the `root` directory
+    directory: "/"
+    # Check the npm registry for updates every day (weekdays)
+    schedule:
+      interval: "weekly"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    # Workflow files stored in the default location of `.github/workflows`
+    # You don't need to specify `/.github/workflows` for `directory`. You can use `directory: "/"`.
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/broken_links.yml

@@ -0,0 +1,134 @@
+name: Broken Links Report
+
+on:
+  schedule:
+    # Run every Saturday at 2 AM UTC
+    - cron: "0 2 * * 6"
+  workflow_dispatch:
+
+jobs:
+  check-links:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # ratchet:actions/[email protected]
+
+      - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # ratchet:actions/[email protected]
+        with:
+          node-version: lts/*
+
+      - uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # ratchet:actions/[email protected]
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install Dependencies
+        run: npm ci --ignore-scripts --no-audit --no-progress --prefer-offline
+
+      - name: Run Link Check
+        id: link_check
+        run: |
+          npm test > link_check_output.txt 2>&1 || true
+          if grep -q "❌ ERROR" link_check_output.txt; then
+            echo "has_errors=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_errors=false" >> $GITHUB_OUTPUT
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create/Update Issue for Broken Links
+        if: steps.link_check.outputs.has_errors == 'true'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # ratchet:actions/github-script@v8
+        with:
+          script: |
+            const fs = require('fs');
+            const output = fs.readFileSync('link_check_output.txt', 'utf8');
+
+            // Extract error information
+            const errorMatch = output.match(/❌ ERROR[\s\S]*$/);
+            const errorInfo = errorMatch ? errorMatch[0] : 'Link check failed - see workflow logs';
+
+            const issueBody = `# 🔗 Broken Links Detected
+
+            The weekly link check has found broken or inaccessible links in the repository.
+
+            ## Error Details
+
+            \`\`\`
+            ${errorInfo}
+            \`\`\`
+
+            ## Action Required
+
+            Please review and fix the broken links above. Options:
+            - Update the URL if the resource moved
+            - Remove the entry if it's permanently unavailable
+            - Add to \`tests/exclude_in_test.json\` if it's a known false positive
+
+            ---
+            *Auto-generated by [broken_links.yml](https://github.com/veggiemonk/awesome-docker/blob/master/.github/workflows/broken_links.yml)*
+            `;
+
+            // Check for existing issue
+            const issues = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'broken-links',
+              per_page: 1
+            });
+
+            if (issues.data.length > 0) {
+              await github.rest.issues.update({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issues.data[0].number,
+                body: issueBody
+              });
+              console.log(`Updated issue #${issues.data[0].number}`);
+            } else {
+              const issue = await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: '🔗 Broken Links Detected - Action Required',
+                body: issueBody,
+                labels: ['broken-links', 'bug']
+              });
+              console.log(`Created issue #${issue.data.number}`);
+            }
+
+      - name: Close Issue if No Errors
+        if: steps.link_check.outputs.has_errors == 'false'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # ratchet:actions/github-script@v8
+        with:
+          script: |
+            const issues = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'broken-links',
+              per_page: 1
+            });
+
+            if (issues.data.length > 0) {
+              await github.rest.issues.update({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issues.data[0].number,
+                state: 'closed',
+                state_reason: 'completed'
+              });
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issues.data[0].number,
+                body: '✅ All links are now working! Closing this issue.'
+              });
+              console.log(`Closed issue #${issues.data[0].number}`);
+            }