Skip to content

feat: refresh all tutorial snapshots with latest GitHub releases#153

Merged
johnxie merged 1 commit intomainfrom
feat/refresh-tutorial-snapshots
Mar 2, 2026
Merged

feat: refresh all tutorial snapshots with latest GitHub releases#153
johnxie merged 1 commit intomainfrom
feat/refresh-tutorial-snapshots

Conversation

@johnxie
Copy link
Owner

@johnxie johnxie commented Mar 2, 2026

Summary

  • New script scripts/refresh_tutorial_snapshots.py: fetches latest repo metadata and release tags from GitHub API for all 189 unique source repos, then updates/inserts "Current Snapshot (auto-updated)" sections in tutorial README.md files
  • 190 tutorials updated with fresh star counts, latest release tags, and publish dates (fetched 2026-03-02)
  • 61 tutorials that previously had no Current Snapshot section now have one auto-inserted
  • Weekly refresh workflow updated to run snapshot refresh with GITHUB_TOKEN before artifact regeneration

Sample results

Tutorial Stars Latest Release
LangChain 128k langchain-core==1.2.16
Ollama 164k v0.17.5
Cline 60.4k v3.57.1
Supabase 98.4k v1.26.02
OpenHands 75.2k 0.43.0

Test plan

  • CI "Docs Health" passes
  • Sample tutorial README.md files show fresh snapshot data
  • refresh_tutorial_snapshots.py --dry-run reports 190 updates
  • Weekly refresh workflow includes the new step

🤖 Generated with Claude Code

Add scripts/refresh_tutorial_snapshots.py that:
- reads tutorial-source-verification.json for repo mapping (189 unique repos)
- fetches repo metadata + latest release via GitHub API (ThreadPoolExecutor, 16 workers)
- updates or inserts "Current Snapshot (auto-updated)" section in each tutorial README.md

Results:
- 190 tutorials updated with fresh star counts and release tags
- 61 tutorials that previously lacked a Current Snapshot section now have one
- 130 existing snapshots updated with current data (stars, latest release, date)
- all data fetched from live GitHub API on 2026-03-02

Also:
- add refresh_tutorial_snapshots.py to weekly-refresh.yml workflow
- pass GITHUB_TOKEN to all API-calling steps in weekly-refresh
- regenerate all artifacts (manifest, snapshot, repo status, discoverability)

All CI checks validated locally:
- docs_health: 0 broken links, 0 missing indexes
- format v2: 130 compliant indexes
- all diff checks: clean

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@johnxie johnxie merged commit 9f2f860 into main Mar 2, 2026
1 check passed
@johnxie johnxie deleted the feat/refresh-tutorial-snapshots branch March 2, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant