doc, punycode: soft-deprecation of the punycode module

As discussed and agreed upon by the CTC, the punycode module bundled
in core is soft-deprecated (docs only) for v7 with an eye towards
hard-deprecation in v8 or later.

Also see discussion in #7552

PR-URL: #7941
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Сковорода Никита Андреевич <[email protected]>

Author: jasnell

doc/api/punycode.md

@@ -1,6 +1,11 @@
 # punycode
 
-    Stability: 2 - Stable
+    Stability: 0 - Deprecated
+
+**The version of the punycode module bundled in Node.js is being deprecated**.
+In a future major version of Node.js this module will be removed. Users
+currently depending on the `punycode` module should switch to using the
+userland-provided [Punycode.js][] module instead.
 
 The `punycode` module is a bundled version of the [Punycode.js][] module. It
 can be accessed using: