docs: document the spec deviations in web apis (#8489)

1 files changed, 3 insertions, 16 deletions

diff --git a/docs/runtime.md b/docs/runtime.md
index 010884968..6c64c4abf 100644
--- a/docs/runtime.md
+++ b/docs/runtime.md
@@ -4,26 +4,13 @@ Documentation for all runtime functions (Web APIs + `Deno` global) can be found
 on
 [`doc.deno.land`](https://doc.deno.land/https/github.com/denoland/deno/releases/latest/download/lib.deno.d.ts).
 
-## Web APIs
+## Web Platform APIs
 
 For APIs where a web standard already exists, like `fetch` for HTTP requests,
 Deno uses these rather than inventing a new proprietary API.
 
-The detailed documentation for implemented Web APIs can be found on
-[doc.deno.land](https://doc.deno.land/https/raw.githubusercontent.com/denoland/deno/master/cli/dts/lib.deno.shared_globals.d.ts).
-Additionally, a full list of the Web APIs which Deno implements is also
-available
-[in the repository](https://github.com/denoland/deno/blob/$CLI_VERSION/cli/rt/README.md).
-
-The TypeScript definitions for the implemented web APIs can be found in the
-[`lib.deno.shared_globals.d.ts`](https://github.com/denoland/deno/blob/$CLI_VERSION/cli/dts/lib.deno.shared_globals.d.ts)
-and
-[`lib.deno.window.d.ts`](https://github.com/denoland/deno/blob/$CLI_VERSION/cli/dts/lib.deno.window.d.ts)
-files.
-
-Definitions that are specific to workers can be found in the
-[`lib.deno.worker.d.ts`](https://github.com/denoland/deno/blob/$CLI_VERSION/cli/dts/lib.deno.worker.d.ts)
-file.
+For more details, view the chapter on
+[Web Platform APIs](./runtime/web_platform_apis.md).
 
 ## `Deno` global