Skip to content

fix: correct documentation bugs and add consistency tests - #16

Open
study8677 wants to merge 1 commit into
zarazhangrui:mainfrom
study8677:fix/docs-consistency-bugs
Open

fix: correct documentation bugs and add consistency tests#16
study8677 wants to merge 1 commit into
zarazhangrui:mainfrom
study8677:fix/docs-consistency-bugs

Conversation

@study8677

@study8677 study8677 commented Mar 29, 2026

Copy link
Copy Markdown

Summary

  • SKILL.md: Add missing prompts.summarize_blogs reference in Step 4 — without this, the LLM has no instruction for remixing blog posts
  • SKILL.md: Include stats.blogPosts in the no-content check (Step 3) — previously, digests with only blog content would be skipped
  • README.md / README.zh-CN.md: Fix podcast count from 5 → 6 and add missing "AI & I by Every" entry
  • examples/sample-digest.md: Remove @handles (violates digest-intro.md "NEVER write Twitter handles with @" rule), fix section order to match digest-intro.md (X → Blogs → Podcasts), add OFFICIAL BLOGS section
  • Add test-docs-consistency.js: 11 automated checks that guard against these docs drifting out of sync again

Test plan

  • node scripts/test-docs-consistency.js — all 11 tests pass
  • Verify podcast count matches config/default-sources.json
  • Verify sample digest follows prompts/digest-intro.md rules
  • Verify SKILL.md Step 4 lists all prompts from prepare-digest.js

🤖 Generated with Claude Code

- SKILL.md: add missing prompts.summarize_blogs reference in Step 4
- SKILL.md: include stats.blogPosts in the no-content check (Step 3)
- README.md/README.zh-CN.md: fix podcast count 5 → 6, add missing "AI & I by Every"
- examples/sample-digest.md: remove @Handles (violates digest-intro.md rules),
  fix section order to X → Blogs → Podcasts, add OFFICIAL BLOGS section
- Add test-docs-consistency.js to guard against future drift

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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