doc: deprecate vm.runInDebugContext

Docs-only deprecation for v8.0.0.
Runtime deprecation planned for v9.0.0.
Removal planned for v10.0.0.

PR-URL: #12243
Reviewed-By: Ali Ijaz Sheikh <ofrobots@google.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: James M Snell <jasnell@gmail.com>

Author: joshgav

doc/api/deprecations.md

@@ -590,6 +590,16 @@ Type: Runtime
 `node debug` corresponds to the legacy CLI debugger which has been replaced with
 a V8-inspector based CLI debugger available through `node inspect`.
 
+<a id="DEP0069"></a>
+### DEP0069: vm.runInDebugContext(string)
+
+Type: Documentation-only
+
+The DebugContext will be removed in V8 soon and will not be available in Node
+10+.
+
+*Note*: DebugContext was an experimental API.
+
 [alloc]: buffer.html#buffer_class_method_buffer_alloc_size_fill_encoding
 [alloc_unsafe_size]: buffer.html#buffer_class_method_buffer_allocunsafe_size
 [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size

doc/api/vm.md

@@ -313,6 +313,8 @@ console.log(util.inspect(sandbox));
 added: v0.11.14
 -->
 
+> Stability: 0 - Deprecated. An alternative is in development.
+
 * `code` {string} The JavaScript code to compile and run.
 
 The `vm.runInDebugContext()` method compiles and executes `code` inside the V8