docs: update for spec stabilization

Author: prestist

docs/configuration-v3_6.md

@@ -1,12 +1,12 @@
 ---
 # This file is automatically generated from config/doc and internal/doc.
 # Do not edit.
-title: Config Spec v3.6.0-experimental
+title: Config Spec v3.7.0-experimental
 parent: Configuration specifications
 nav_order: 50
 ---
 
-# Configuration Specification v3.6.0-experimental
+# Configuration Specification v3.7.0-experimental
 
 _NOTE_: This pre-release version of the specification is experimental and is subject to change without notice or regard to backward compatibility.
 
@@ -15,7 +15,7 @@ The Ignition configuration is a JSON document conforming to the following specif
 <div id="spec-docs"></div>
 
 * **ignition** (object): metadata about the configuration itself.
-  * **version** (string): the semantic version number of the spec. The spec version must be compatible with the latest version (`3.6.0-experimental`). Compatibility requires the major versions to match and the spec version be less than or equal to the latest version. `-experimental` versions compare less than the final version with the same number, and previous experimental versions are not accepted.
+  * **version** (string): the semantic version number of the spec. The spec version must be compatible with the latest version (`3.7.0-experimental`). Compatibility requires the major versions to match and the spec version be less than or equal to the latest version. `-experimental` versions compare less than the final version with the same number, and previous experimental versions are not accepted.
   * **_config_** (object): options related to the configuration.
     * **_merge_** (list of objects): a list of the configs to be merged to the current config.
       * **source** (string): the URL of the config. Supported schemes are `http`, `https`, `tftp`, `s3`, `arn`, `gs`, and [`data`](https://tools.ietf.org/html/rfc2397). When using `http`, it is advisable to use the verification option to ensure the contents haven't been modified.

docs/configuration-v3_6_experimental.md docs/configuration-v3_7_experimental.mddocs/configuration-v3_6_experimental.md renamed to docs/configuration-v3_7_experimental.md

@@ -11,7 +11,11 @@ Occasionally, there are changes made to Ignition's configuration that break back
 {:toc}
 
 
-## From Version 3.5.0 to 3.6.0-experimental
+## From Version 3.6.0 to 3.7.0-experimental
+
+There are not any breaking changes between versions 3.6.0 and 3.7.0-experimental of the configuration specification. Any valid 3.6.0 configuration can be updated to a 3.7.0-experimental configuration by simply changing the version string in the config.
+
+## From Version 3.5.0 to 3.6.0
 
 ### Special mode bits supported
 
@@ -21,7 +25,7 @@ The `mode` field of the `files` and `directories` sections now respects the setu
 ```json
 {
   "ignition": {
-    "version": "3.6.0-experimental"
+    "version": "3.6.0"
   },
   "storage": {
     "files": [{

docs/migrating-configs.md

@@ -10,6 +10,10 @@ nav_order: 9
 
 ### Features
 
+- Mark the 3.6.0 config spec as stable
+- No longer accept configs with version 3.6.0-experimental
+- Create new 3.7.0-experimental config spec from 3.6.0
+
 ### Changes
 
 ### Bug fixes

docs/release-notes.md

@@ -19,6 +19,7 @@ We recommend that you always use the latest **stable** specification to benefit
 from new features and bug fixes. The following **stable** specification
 versions are currently supported in Ignition:
 
+- [v3.6.0](configuration-v3_6.md)
 - [v3.5.0](configuration-v3_5.md)
 - [v3.4.0](configuration-v3_4.md)
 - [v3.3.0](configuration-v3_3.md)
@@ -33,7 +34,7 @@ and testing** as it is subject to change **without warning or announcement**.
 The following **experimental** specification version is currently available in
 Ignition:
 
-- [v3.6.0-experimental](configuration-v3_6_experimental.md)
+- [v3.7.0-experimental](configuration-v3_7_experimental.md)
 
 ## Legacy spec 2.x configuration specifications
 
@@ -55,4 +56,5 @@ recommended to use the latest Ignition release.
 | 3.2.0        | 2.7.0            |
 | 3.3.0        | 2.11.0           |
 | 3.4.0        | 2.15.0           |
-| 3.5.0        | 2.20.0           |
+| 3.5.0        | 2.20.0           |
+| 3.6.0        | 2.26.0           |

docs/specs.md

@@ -12,7 +12,7 @@ hash schematyper 2>/dev/null || {
     exit 1
 }
 
-specs="v3_0 v3_1 v3_2 v3_3 v3_4 v3_5 v3_6_experimental"
+specs="v3_0 v3_1 v3_2 v3_3 v3_4 v3_5 v3_6 v3_7_experimental"
 
 for spec in $specs
 do