Document the Python extension's debugger API for other extensions

[brettcannon]

microsoft/vscode-python#3121

This is now being relied on by the Functions extension, so it's as official as we can get as an API for other extensions to rely on.

[brettcannon]

Will take care of microsoft/vscode-python#3333

[kraigb]

@brettcannon @DonJayamanne Please review https://github.com/Microsoft/vscode-docs/blob/python-debug-api/docs/python/debugging.md#api-to-access-the-debugger-from-other-extensions for accuracy. I'm not sure if there are more details needed for the namespace of the API, for example.

Feel free to make edits directly in the branch.

I'm checking to see if the python-debug-api branch can get staged up to verify the rendering of the API formatting.

[kraigb]

@brettcannon @DonJayamanne Any comments on the API docs here?

[DonJayamanne]

Will get back to you tomorrow

[DonJayamanne]

Can we put this on hold for now.
Personally I don't see any value in documenting this.
There's more that'll need to be documented for anyone to be able to use this.
Also there are a few changes that'll have to be made.

[kraigb]

Sure, these changes are just in a branch, so they can live there for however long.

[DonJayamanne]

Tracking here microsoft/vscode-python#4155

[kraigb]

OK, I'll close this one for the time being, beause you're tracking elsewhere. Easy enough to reopen at a later time if needs be.

[DonJayamanne]

Created an issue upstream, as that's something we monitor