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).

[StanFromIreland]

Suggested change

	3. Locate the ``PyRuntim`` section. Section names in the PE format are limited
	3. Locate the ``PyRuntime`` section. Section names in the PE format are limited

[chris-eibl]

That's no typo and due to the 8 byte length limit in the PE format. Maybe that should be reformulated to make it clearer?

[ivonastojanovic]

Updated the explanation to clarify the PE section name limit. Let me know what you think.