Add WebSocket connection domain

[gryphon2411]

Summary

• add an isolated websocket Sphinx domain with connection directives, roles, routing table, directional message fields, and stable anchors
• document the MVP and add package-local French and Spanish catalogs
• preserve HTTP behavior while sharing typed-path rendering, and add Sphinx 6.2 compatibility coverage

Verification

• tox r
• independent senior-engineer review; all findings were fixed and rechecked

Closes #25

[gryphon2411]

@stevepiercy, this implements the small separate WebSocket-domain MVP discussed in #25. It passes the full tox r suite; I would appreciate your review when you have time.

[read-the-docs-community]

Documentation build overview

📚 sphinxcontrib-httpdomain | 🛠️ Build #34101388 | 📁 Comparing 3fcdc46 against latest (1d96b0f)

  🔍 Preview build  

2 files changed

+ websocket-routingtable.html
± index.html

[stevepiercy]

I'm going to close then reopen this PR to see if that will trigger a test build and allow me to update the branch with main. Please stand by.

[stevepiercy]

@gryphon2411 Can you update your branch to main? I made a recent fix for the py314 environment for documentation links, but the usual button that allows me to update the branch on PRs doesn't show up, even though I'm an Admin on this repo. Then I can do a proper review. Thank you!

[gryphon2411]

@stevepiercy The branch is now rebased onto current main (738392e), and tox r passes locally. It should be ready for your review.

[stevepiercy]

@loelkes and @ilan-theodoro, since you liked this feature request, and I lack familiarity with WebSocket, I'd greatly appreciate your review on this PR.

If there is anyone else who wants this feature, please feel free to review and provide feedback. This is a community effort.

[stevepiercy]

This is excellent work, and thank you for cleaning up my omission in the change log. I have a few suggestions for you to consider. Would you please take care?

I feel confident that everything in this PR is solid, including the translations and moving the locale directory, documentation, and project meta information. Because I'm not familiar with WebSocket usage and its testing, I'd like to get another review from someone who has that familiarity. Do you have a colleague who can pitch in? Please let me know. Thank you!

[gryphon2411]

@stevepiercy I have applied all of your inline suggestions and rebased the branch onto current main. The full tox r suite passes locally.

I do not have an additional human reviewer to nominate, but I appreciate your invitations to @loelkes and @ilan-theodoro. I will gladly address any WebSocket-specific feedback they provide.

[stevepiercy]

@gryphon2411 thank you for this long-awaited feature, and establishing a base for future improvements to WebSockets API documentation. I appreciate your patience and effort to improve sphinxcontrib-httpdomain.

If @loelkes or @ilan-theodoro would like to add on or offer feedback, they're welcome to do so anytime.

I'll merge after CI checks pass.

[stevepiercy]

@gryphon2411 I think your base branch is protected, and therefore I can't easily update your branch against main. Would you please do so? Then I can run CI checks and merge. Please let me know. Thank you!