fix sort

Author: lgarber-akamai

linodecli/documentation/template_data.py

@@ -185,14 +185,14 @@ def from_iter(
         cls,
         data: Iterable[T],
         get_parent: Callable[[T], Optional[str]],
-        get_name: Callable[[T], str],
+        sort_key: Callable[[T], Any],
     ) -> List[Self]:
         """
         Builds a list of FieldSection created from the given data using the given functions.
 
         :param data: The data to partition.
         :param get_parent: A function returning the parent of this entry.
-        :param get_name: A function returning the name of this entry.
+        :param sort_key: A function passed into the `key` argument of the sort function.
 
         :returns: The built list of sections.
         """
@@ -206,7 +206,7 @@ def from_iter(
 
         return sorted(
             [
-                FieldSection(name=key, entries=sorted(section, key=get_name))
+                FieldSection(name=key, entries=sorted(section, key=sort_key))
                 for key, section in sections.items()
             ],
             key=lambda section: section.name,
@@ -301,7 +301,7 @@ def from_openapi(cls, operation: OpenAPIOperation) -> Self:
                     if isinstance(arg, OpenAPIRequestArg)
                 ),
                 get_parent=lambda arg: arg.parent if arg.is_child else None,
-                get_name=lambda arg: arg.path,
+                sort_key=lambda arg: (not arg.required, arg.path),
             )
 
             result.argument_sections_names = {
@@ -319,7 +319,7 @@ def from_openapi(cls, operation: OpenAPIOperation) -> Self:
                     if "." in attr.name
                     else None
                 ),
-                get_name=lambda arg: arg.name,
+                sort_key=lambda attr: attr.name,
             )
 
             result.attribute_sections_names = {