docs: order configuration template fileds alphabetically (#12771)

tools/doc-generator/main.go

@@ -15,6 +15,7 @@ import (
 
 	"github.com/grafana/loki/v3/pkg/loki"
 	"github.com/grafana/loki/v3/tools/doc-generator/parse"
+	"golang.org/x/exp/slices"
 )
 
 const (
@@ -94,6 +95,18 @@ func annotateFlagPrefix(blocks []*parse.ConfigBlock) {
 }
 
 func generateBlocksMarkdown(blocks []*parse.ConfigBlock) string {
+	slices.SortFunc(blocks, func(a, b *parse.ConfigBlock) int {
+		if a.Name < b.Name {
+			return -1
+		}
+
+		if a.Name > b.Name {
+			return 1
+		}
+
+		return 0
+	})
+
 	md := &markdownWriter{}
 	md.writeConfigDoc(blocks)
 	return md.string()

tools/doc-generator/parse/root_blocks.go

@@ -12,6 +12,7 @@ import (
 	"github.com/grafana/dskit/kv/memberlist"
 	"github.com/grafana/dskit/runtimeconfig"
 	"github.com/grafana/dskit/server"
+	"golang.org/x/exp/slices"
 
 	"github.com/grafana/loki/v3/pkg/analytics"
 	"github.com/grafana/loki/v3/pkg/bloomcompactor"
@@ -288,3 +289,16 @@ Named store from this example can be used by setting object_store to store-1 in
 		},
 	}
 )
+
+func init() {
+	slices.SortFunc(RootBlocks, func(a, b RootBlock) int {
+		if a.Name < b.Name {
+			return -1
+		}
+		if a.Name > b.Name {
+			return 1
+		}
+
+		return 0
+	})
+}