Rename function and add synopsis

Author: o-l-a-v

bin/formatjson.ps1

@@ -40,8 +40,8 @@ Get-ChildItem $Dir -Filter "$App.json" -Recurse | ForEach-Object {
     # Parse JSON
     $json = [PSCustomObject](parse_json -path $file)
 
-    # Sort JSON root properties
-    $json = [PSCustomObject](Sort-ScoopManifestRootProperties -JsonAsObject $json)
+    # Sort JSON root properties according to schema.json, and level one child properties alphabetically
+    $json = [PSCustomObject](Sort-ScoopManifestProperties -JsonAsObject $json)
 
     # Beautify
     $json = [string](ConvertToPrettyJson -data $json)

lib/json.ps1

@@ -213,7 +213,11 @@ function normalize_values([psobject] $json) {
     return $json
 }
 
-function Sort-ScoopManifestRootProperties {
+function Sort-ScoopManifestProperties {
+    <#
+        .SYNOPSIS
+            Sort JSON root properties according to schema.json, and level one child properties alphabetically.
+    #>
     [OutputType([PSCustomObject])]
 
     Param(