From d744c0c6d9a557bbaa2a23571ffb3acabf19c35a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Tue, 20 Jul 2021 16:25:36 +0200 Subject: chore: move docs to separate repository --- docs/runtime/stability.md | 32 -------------------------------- 1 file changed, 32 deletions(-) delete mode 100644 docs/runtime/stability.md (limited to 'docs/runtime/stability.md') diff --git a/docs/runtime/stability.md b/docs/runtime/stability.md deleted file mode 100644 index 9cdc1eea8..000000000 --- a/docs/runtime/stability.md +++ /dev/null @@ -1,32 +0,0 @@ -## Stability - -As of Deno 1.0.0, the `Deno` namespace APIs are stable. That means we will -strive to make code working under 1.0.0 continue to work in future versions. - -However, not all of Deno's features are ready for production yet. Features which -are not ready, because they are still in draft phase, are locked behind the -`--unstable` command line flag. - -```shell -deno run --unstable mod_which_uses_unstable_stuff.ts -``` - -Passing this flag does a few things: - -- It enables the use of unstable APIs during runtime. -- It adds the - [`lib.deno.unstable.d.ts`](https://doc.deno.land/https/raw.githubusercontent.com/denoland/deno/main/cli/dts/lib.deno.unstable.d.ts) - file to the list of TypeScript definitions that are used for type checking. - This includes the output of `deno types`. - -You should be aware that many unstable APIs have **not undergone a security -review**, are likely to have **breaking API changes** in the future, and are -**not ready for production**. - -### Standard modules - -Deno's standard modules (https://deno.land/std/) are not yet stable. We -currently version the standard modules differently from the CLI to reflect this. -Note that unlike the `Deno` namespace, the use of the standard modules do not -require the `--unstable` flag (unless the standard module itself makes use of an -unstable Deno feature). -- cgit v1.2.3