Merge pull request #14383 from dotty-staging/update-experimental-docpage

Update experimental overview page

Author: odersky

docs/docs/reference/other-new-features/explicit-nulls.md renamed to docs/docs/reference/experimental/explicit-nulls.md

@@ -1,6 +1,6 @@
 ---
 layout: doc-page
-title: "Experimental language features"
+title: "Overview"
 movedTo: https://docs.scala-lang.org/scala3/reference/experimental/overview.html
 ---
 
@@ -13,8 +13,16 @@ They are enabled by importing the feature or using the `-language` compiler flag
 * `fewerBraces`: Enable support for using indentation for arguments.
 * [`genericNumberLiterals`](./numeric-literals.md): Enable support for generic number literals.
 * [`namedTypeArguments`](./named-typeargs.md): Enable support for named type arguments
+* [`saferExceptions`](./canthrow.md): Enable support for checked exceptions.
 
 ### Experimental language imports
 
 In general, experimental language features can be imported in an experimental scope (see [experimental definitions](../other-new-features/experimental-defs.md).
 They can be imported at the top-level if all top-level definitions are @experimental.
+
+### Experimental language features supported by special compiler options
+
+Some experimental language features that are still in research and development can be enabled with special compiler options. These include
+
+* [`-Yexplicit-nulls`](./explicit-nulls.md). Enable support for tracking null references in the type system.
+

docs/docs/reference/experimental/overview.md

@@ -64,7 +64,6 @@ sidebar:
           - page: docs/reference/other-new-features/targetName.md
           - page: docs/reference/other-new-features/control-syntax.md
           - page: docs/reference/other-new-features/indentation.md
-          - page: docs/reference/other-new-features/explicit-nulls.md
           - page: docs/reference/other-new-features/safe-initialization.md
           - page: docs/reference/other-new-features/type-test.md
           - page: docs/reference/other-new-features/experimental-defs.md
@@ -114,10 +113,9 @@ sidebar:
           - page: docs/reference/experimental/overview.md
           - page: docs/reference/experimental/canthrow.md
           - page: docs/reference/experimental/erased-defs.md
-          - page: docs/reference/experimental/erased-defs-spec.md
           - page: docs/reference/experimental/named-typeargs.md
-          - page: docs/reference/experimental/named-typeargs-spec.md
           - page: docs/reference/experimental/numeric-literals.md
+          - page: docs/reference/experimental/explicit-nulls.md
       - page: docs/reference/syntax.md
       - title: Language Versions
         index: docs/reference/language-versions/language-versions.md