improve description

Author: BrunoQuaresma

provider/metadata.go

@@ -105,7 +105,7 @@ func metadataResource() *schema.Resource {
 						},
 						"order": {
 							Type:        schema.TypeInt,
-							Description: "The order in which this item will be displayed relative to other items. Lower numbers appear first.",
+							Description: "The order determines the position of item in the UI presentation. The lowest order is shown first and items with equal order are sorted by key (ascending order).",
 							ForceNew:    true,
 							Computed:    true,
 						},