ported

Author: orbsmiv

docs/experimental-features.md

@@ -1,18 +1,23 @@
-.. _experimental_features:
+# Experimental features {: #experimental_features }
 
-Experimental features
-=====================
+First introduced in EasyBuild v2.1.0 (see
+[EasyBuild v2.1.0 Release Notes][release_notes_v2.1.0]), experimental features can only be used by enabling the
+`--experimental` configuration option.
 
-First introduced in EasyBuild v2.1.0 (see :ref:`EasyBuild v2.1.0 Release Notes <release_notes_v2.1.0>`),
-experimental features can only be used by enabling the ``--experimental`` configuration option.
-
-An experimental feature indicates to users that these features may change significantly in a future release
-and should be used only for testing, not (yet) for production usage.
+An experimental feature indicates to users that these features may
+change significantly in a future release and should be used only for
+testing, not (yet) for production usage.
 
 Currently enabled experimental features include:
 
- * support for easyconfig files in YAML syntax (see :ref:`easyconfig_yeb_format`)
- * support for generating container recipes & images (see :ref:`containers`)
- * support for using easystack files (see :ref:`easystack`)
- * support for trying to update versions of the dependencies of an easyconfig based on what is available in the robot path (see :ref:`basic_usage_help`)
- * support for installing extensions in parallel (see :ref:`installing_extensions_in_parallel`)
+- support for easyconfig files in YAML syntax (see
+    [Writing easyconfig files in YAML syntax][easyconfig_yeb_format])
+- support for generating container recipes & images (see
+    [Generating container recipes & images][containers])
+- support for using easystack files (see
+    [Easystack files][easystack])
+- support for trying to update versions of the dependencies of an
+    easyconfig based on what is available in the robot path (see
+    [Output of `eb --help`][basic_usage_help])
+- support for installing extensions in parallel (see
+    [Installing extensions in parallel][installing_extensions_in_parallel])

docs/version-specific/eb-help.md

@@ -1,4 +1,4 @@
-# Output of `eb --help`
+# Output of `eb --help` {: #basic_usage_help }
 
 !!! warning
     This page will soon replace <https://docs.easybuild.io/en/latest/eb_help.html>.