docs: improve version documentation

.golangci.next.reference.yml

@@ -4,6 +4,8 @@
 # This file is not a configuration example,
 # it contains the exhaustive configuration with explanations of the options.
 
+# Defines the configuration version.
+# The only possible value is "2".
 version: "2"
 
 linters:

.golangci.reference.yml

@@ -4,6 +4,8 @@
 # This file is not a configuration example,
 # it contains the exhaustive configuration with explanations of the options.
 
+# Defines the configuration version.
+# The only possible value is "2".
 version: "2"
 
 linters:

docs/src/docs/usage/configuration.mdx

@@ -42,14 +42,6 @@ The configuration file can be validated with the JSON Schema: https://golangci-l
 
 { .ConfigurationExample }
 
-### `version` configuration
-
-```yaml
-# Defines the configuration version.
-# The only possible value is "2".
-version: "2"
-```
-
 ## Command-Line Options
 
 ### run

scripts/website/expand_templates/linters.go

@@ -206,8 +206,7 @@ type ExampleSnippetsExtractor struct {
 
 func NewExampleSnippetsExtractor() *ExampleSnippetsExtractor {
 	return &ExampleSnippetsExtractor{
-		// TODO(ldez) replace .golangci.next.reference.yml by .golangci.reference.yml
-		referencePath: ".golangci.next.reference.yml",
+		referencePath: ".golangci.reference.yml",
 		assetsPath:    "assets",
 	}
 }
@@ -281,11 +280,19 @@ func (e *ExampleSnippetsExtractor) extractExampleSnippets(example []byte) (*Sett
 		}
 
 		if node.Value == "version" {
-			node.HeadComment = `See the dedicated "version" documentation section.`
-			newNode = nextNode
-		}
+			n := &yaml.Node{
+				HeadComment: fmt.Sprintf("See the dedicated %q documentation section.", node.Value),
+				Kind:        node.Kind,
+				Style:       node.Style,
+				Tag:         node.Tag,
+				Value:       node.Value,
+				Content:     node.Content,
+			}
 
-		globalNode.Content = append(globalNode.Content, node, newNode)
+			globalNode.Content = append(globalNode.Content, n, nextNode)
+		} else {
+			globalNode.Content = append(globalNode.Content, node, newNode)
+		}
 
 		if node.Value == keyLinters || node.Value == keyFormatters {
 			for i := 0; i < len(nextNode.Content); i++ {