Skip to content

fix(hackernews): docs say num_comments, matching the emitted key (#106) - #110

Merged
vedaant00 merged 1 commit into
mainfrom
fix/hn-comments-doc-106
Aug 7, 2026
Merged

fix(hackernews): docs say num_comments, matching the emitted key (#106)#110
vedaant00 merged 1 commit into
mainfrom
fix/hn-comments-doc-106

Conversation

@vedaant00

@vedaant00 vedaant00 commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

The scraper emits the comment count under 'num_comments' (the Algolia HN field name), but the sync docstring, the MCP tool description, and its usage hint all called the field 'comments'. Anyone reading the docs would look for a key that isn't there.

Align the three doc sites to the real key. Left the 'comment' tags filter value alone (that one is correct). Added assertions to the HN parse test that lock the key to 'num_comments' and that 'comments' is absent.

Closes #106

The scraper emits the comment count under 'num_comments' (the Algolia
HN field name), but the sync docstring, the MCP tool description, and
its usage hint all called the field 'comments'. Anyone reading the
docs would look for a key that isn't there.

Align the three doc sites to the real key. Left the 'comment' tags
filter value alone (that one is correct). Added assertions to the HN
parse test that lock the key to 'num_comments' and that 'comments' is
absent.
@vedaant00
vedaant00 merged commit 2d39778 into main Aug 7, 2026
6 checks passed
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.

search_hackernews doc says 'comments' but the scraper emits 'num_comments'

2 participants