docs(api): order client pages for first-time readers

[MarTrepodi]

Summary

The SwgohComlink and SwgohComlinkAsync API pages now share one outline, so a new reader goes from creating a client to its advanced options in the same order on either page:

1. Quick Start
2. Connecting to Comlink
3. Handling Errors
4. Retries and Pacing
5. Stat Calculation
6. API Reference

docs/api/comlink.md

• Adds an intro, a Quick Start (context manager and close()), and a Connecting section covering url vs host/port, HMAC keys and the ACCESS_KEY/SECRET_KEY fallback. Before this change the page opened with retry backoff details.
• Adds short Handling Errors and Stat Calculation sections that link to the exceptions and StatCalc pages.
• The retry text is unchanged; its example ally code now matches the rest of the docs.

docs/api/async.md

• Moves error handling ahead of retries.
• Adds a short Connecting section that links to the sync page instead of repeating it.
• Renames "Async Stat Calculation" to "Stat Calculation" so the headings match across both pages.

The #retries-and-pacing anchor, which other pages link to, is unchanged.

Test plan

• uv run --group docs mkdocs build --strict passes
• New in-page anchors (#connecting-to-comlink, #swgoh_comlink.swgoh_comlink.SwgohComlink) exist in the built HTML

🤖 Generated with Claude Code