Skip to content

Add guide for choosing a client - #242

Merged
samuel-williams-shopify merged 6 commits into
mainfrom
add-choosing-a-client-guide
Aug 21, 2026
Merged

Add guide for choosing a client#242
samuel-williams-shopify merged 6 commits into
mainfrom
add-choosing-a-client-guide

Conversation

@samuel-williams-shopify

@samuel-williams-shopify samuel-williams-shopify commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a decision-oriented guide comparing the shared and explicit Internet interfaces with Client
  • explain destination scope, connection configuration, ownership, pooling, and response cleanup
  • document how HTTP libraries should accept explicit dependencies, including Async::HTTP::Client, Protocol::HTTP middleware, async-rest, and Faraday via async-http-faraday
  • link the new guide from Getting Started and place it before Testing in the guide navigation

Validation

  • all 5 guide examples executed successfully
  • all 18 Ruby blocks across the guide set compile
  • both new external documentation links resolve successfully
  • the new static guide page and navigation rendered successfully
  • the full static task reached the existing local Pagefind limitation: the configured global npx command is unsupported after content generation

Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
Assisted-By: devx/1b826335-8b80-44c3-895e-60cc3d688770
@samuel-williams-shopify
samuel-williams-shopify merged commit 82c7137 into main Aug 21, 2026
34 of 40 checks passed
@samuel-williams-shopify
samuel-williams-shopify deleted the add-choosing-a-client-guide branch August 21, 2026 06:22
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