Update doc comments on service-connection-provider.ts

[tsmaeder]

What it does

Add some documentation to make the usage of the local/remote service id's more understandable.

contributed on behalf of STMicroelectronics

How to test

n/a

Follow-ups

Review checklist

• [ ] As an author, I have thoroughly tested my changes and carefully followed the review guidelines

Reminder for reviewers

• As a reviewer, I agree to behave in accordance with the review guidelines

[tsmaeder]

@eneufeld

[tsmaeder]

You mention SSH a bunch, but this isn't the only way to use a remote system

The idea is not to give a complete description of the system here, only an example.