Skip to content

README: lead with what the SDK does - #72

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 12 scraping snippets execute with HTTPX mock transports, including async, raw-response, and streaming examples. Every serialized request validates against the OpenAPI scrape schema; verified json_.data and highlightsParams serialization. git diff --check passes. No live API requests were made.

Sources checked:

  • api.md
  • src/context/dev/resources/web.py
  • src/context/dev/types/web_scrape_params.py
  • src/context/dev/types/web_scrape_response.py

@YahiaBakour
YahiaBakour merged commit 5c53e24 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