doc: Deprecate old debug protocol
Checklist
-
documentation is changed or added -
commit message follows commit guidelines
Affected core subsystem(s)
doc
Description of change
As discussed in https://github.com/nodejs/node/pull/10276, we'd want to add a soft deprecation of the --debug
flag to the docs.
This just adds the deprecation to the "advanced usage" section, not to the overall page. I think we can actually keep supporting node debug <filename>
since it doesn't leak the protocol used (as pid and url do, both of which could have been started with a different version of node).