update

Author: blva

tools/cli/internal/cli/split/split.go

@@ -91,7 +91,7 @@ func (o *Opts) saveVersionedOas(oas *openapi3.T, version string) error {
 	}
 
 	path = strings.Replace(path, "."+o.format, fmt.Sprintf("-%s.%s", version, o.format), 1)
-	return openapi.SaveToFile(path, o.format, oas, o.fs)
+	return openapi.Save(path, oas, o.format, o.fs)
 }
 
 func (o *Opts) PreRunE(_ []string) error {

tools/cli/internal/openapi/file.go

@@ -118,6 +118,8 @@ func SerializeToYAML(data []byte) ([]byte, error) {
 	return yamlData, nil
 }
 
+// Save saves the OpenAPI document to a file in the specified format. This is important for public
+// OpenAPI documents as it ensures to follow the order of the Spec object.
 func Save(path string, oas *openapi3.T, format string, fs afero.Fs) error {
 	return SaveToFile(path, format, newSpec(oas), fs)
 }