doc: mark global object as legacy

mertcanaltin · MoLow · commit b80e006c17cb · 2023-07-07T00:06:12.000+03:00
PR-URL: #47819 Fixes: #47784 Reviewed-By: Tobias Nießen <tniessen@tnie.de> Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
diff --git a/doc/api/globals.md b/doc/api/globals.md
@@ -469,6 +469,8 @@ added: v0.1.27
 
 <!-- type=global -->
 
+> Stability: 3 - Legacy. Use [`globalThis`][] instead.
+
 * {Object} The global namespace object.
 
 In browsers, the top-level scope is the global scope. This means that
@@ -908,6 +910,7 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
 [`console`]: console.md
 [`exports`]: modules.md#exports
 [`fetch()`]: https://developer.mozilla.org/en-US/docs/Web/API/fetch
+[`globalThis`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis
 [`module`]: modules.md#module
 [`perf_hooks.performance`]: perf_hooks.md#perf_hooksperformance
 [`process.nextTick()`]: process.md#processnexttickcallback-args
