How mickpletcher/best-of-github works
Best of GitHub is a curated repository catalog with two automated discovery products: a daily random pick and weekly star-ranked reports. Users browse the curated README and generated reports; scheduled GitHub Actions refresh the automated content. The daily updater selects a safe repository and updates both the README block and archive. The weekly updater fetches repositories and writes ranked reports, while a separate validator checks report structure and README freshness. Edges reflect the README and sampled script excerpts; workflow implementation details were not sampled.
Main entry points: update_github_of_the_day.py Daily Picker · update_weekly_rankings.py Weekly Generator · validate_weekly_rankings.py Report Validator · README.md Curated Picks
Components 9
Curated Catalog
- Curated Picks
README.md
Daily Discovery
- Daily Picker
scripts/update_github_of_the_day.py - Daily Archive
github-of-the-day-archive.md
Weekly Rankings
- Weekly Generator
scripts/update_weekly_rankings.py - Top 100 Report
weekly-top-100-github-repositories.md - Top 250 Report
weekly-top-250-github-repositories.md
Report Validation
- Report Validator
scripts/validate_weekly_rankings.py
Other components
- Catalog Reader
- GitHub Search API
Connections 10
- Catalog Reader → Curated Picks: browses
README.md - Daily Picker → GitHub Search API: queries
scripts/update_github_of_the_day.py - Daily Picker → Curated Picks: updates pick
scripts/update_github_of_the_day.py - Daily Picker → Daily Archive: appends selection
scripts/update_github_of_the_day.py - Weekly Generator → GitHub Search API: fetches repositories
scripts/update_weekly_rankings.py - Weekly Generator → Top 100 Report: writes report
README.md - Weekly Generator → Top 250 Report: writes report
README.md - Report Validator → Top 100 Report: validates
scripts/validate_weekly_rankings.py - Report Validator → Top 250 Report: validates
scripts/validate_weekly_rankings.py - Report Validator → Curated Picks: checks freshness
scripts/validate_weekly_rankings.py