gh-131591: Add remote debugging attachment protocol documentation

[ivonastojanovic]

• Issue: Implement PEP 768 – Safe external debugger interface for CPython #131591

---

📚 Documentation preview 📚: https://cpython-previews--132638.org.readthedocs.build/en/132638/howto/remote_debugging.html

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[pablogsal]

@hugovk@willingc I will review this today but it would awesome if you can give this a go as well :)

[hugovk]

Thank you, very clearly written.

[StanFromIreland]

From a quick look at the first section. (Edit: I was reviewing when Hugo posted his, there is some overlap)

Everything needs to be wrapped to 79 chars -- this affects almost every line.

[pablogsal]

This is a spec so we should write in a more formal way. The formal tone is better suited for this technical documentation because it establishes the necessary precision required when explaining technical operations like memory manipulation and code injection. This formality isn't just stylistic preference—it serves a functional purpose by reducing ambiguity. @ivonastojanovic here are a bunch of advice on how to change the tone:

1. Maintain consistent formality: Avoid casual phrases like "That's why" or constructions that directly address the reader as "you." Instead, use more objective phrasing such as "This protocol requires two pieces of information."

2. Use passive voice (some times): While active voice is generally clearer, technical documentation often benefits from passive voice where the focus should be on processes rather than actors (e.g., "The PyRuntime structure is located" rather than "You need to find the PyRuntime structure").

3. Minimize colloquial language: Replace informal transitions like "Next up" with more formal alternatives such as "Subsequently" or "The following step involves."

[chris-eibl]

Maybe a short summary about the life time of the remote script shall be added to the documentation, too?
See #132712 (comment).

[pablogsal]

LGTM

I added a bunch of paragraphs with architecture-specific hints on how to do the diferent parts (specially since macOS and Windows are a bit more arcane).

Fantastic job @ivonastojanovic! ✨

[willingc]

@pablogsal Sorry I missed this ping last week. I just skimmed the docs, and it looks great! Hope all is well. Your name came up a bunch at PyTexas in my chats with Bloomberg folks. 😄

[pablogsal]

@pablogsal Sorry I missed this ping last week. I just skimmed the docs, and it looks great! Hope all is well. Your name came up a bunch at PyTexas in my chats with Bloomberg folks. 😄

Thanks @willingc ❤️