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 #34008020 | 📁 Comparing fbb99f1 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!

[stevepiercy]

I think this should be consistent with the theme used in sphinxcontrib.httpdomain's docs/conf.py.

Suggested change

	"html_theme = 'alabaster'\n"
	"html_theme = 'sphinxdoc'\n"

[stevepiercy]

Suggested change

	This contrib extension, :mod:`sphinxcontrib.httpdomain`, provides a Sphinx
	This contrib extension, :mod:`sphinxcontrib.httpdomain`, provides Sphinx

[stevepiercy]

Let's include all the pieces, link to the issue, and give you credit.

Suggested change

	connections.
	connections, including tests, usage documentation, project meta information,
	and translations. [:pull:`115` by @gryphon2411]

[stevepiercy]

Also thank you for handling my oversight in the change log to add a release date and add an Unreleased section. I appreciate the care you put into your work.

[stevepiercy]

Please move this excellent new section just before the Author and License section. I want all the HTTP sections grouped together. We'll also need to disambiguate some headings and targets.

[stevepiercy]

Let's create a target for future use, and disambiguate from HTTP options.

Suggested change

	Options
	```````
	.. _websocket-options:
	WebSocket options
	`````````````````

[stevepiercy]

TIL, in suggestions, there needs to be three more backticks than those in the underline for GitHub markdown to render them in the suggestion. The default three backticks is not adequate.

[stevepiercy]

Add context.

Suggested change

	HTTP directives
	---------------

[stevepiercy]

Disambiguate from WebSocket options.

Suggested change

	.. _http-options:
	HTTP options
	````````````