Skip to content

README: lead with what the SDK does - #78

Merged
YahiaBakour merged 3 commits into
mainfrom
docs/context-dev-readme-opening
Oct 8, 2026
Merged

YahiaBakour merged 3 commits into
mainfrom
docs/context-dev-readme-opening

Conversation

@YahiaBakour

@YahiaBakour YahiaBakour commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Leads with a scrape request that returns markdown and HTML, followed by runnable examples for structured JSON, relevant highlights, and screenshots. Replaces every brand-lookup code sample throughout the README with scraping, including applicable async, error handling, retry, timeout, typing, and raw-response examples.

Also adds the capability table and agent integration links, and removes the Stainless attribution. Only README.md changes; source code, package names, versions, and generated API references are untouched.

Titles remain configured centrally in https://github.com/context-dot-dev/brand-dev-server/pull/1669. That companion PR now also configures scraping for both default and headline examples. The README examples are updated directly so these PRs show the complete scraping documentation immediately.

Validation: All 10 scraping snippets pass ruby -c. Request and response fields, including highlights and typed parameter examples, match the SDK models and RBI definitions. git diff --check passes. No live API requests were made.

Sources checked:

  • lib/context_dev/resources/web.rb
  • lib/context_dev/models/web_scrape_params.rb
  • lib/context_dev/models/web_scrape_response.rb
  • lib/context_dev/resources/parse.rb
  • lib/context_dev/resources/batch.rb
  • lib/context_dev/resources/monitors.rb
  • lib/context_dev/resources/brand.rb
  • rbi/context_dev/models/web_scrape_params.rbi
  • rbi/context_dev/resources/web.rbi

This repository has no api.md; method names were verified in its resource/service definitions.

@YahiaBakour
YahiaBakour merged commit decf605 into main Oct 8, 2026
10 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.

1 participant