feat:Attempt Improve docstring (closes #503).

end_to_end_tests/golden-record/my_test_api_client/api/default/get_common_parameters.py

@@ -44,6 +44,13 @@ def sync_detailed(
     client: Client,
     common: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+    Args:
+        common (Union[Unset, None, str]): None:
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         common=common,
@@ -62,6 +69,15 @@ async def asyncio_detailed(
     client: Client,
     common: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        common (Union[Unset, None, str]): None:
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         common=common,

end_to_end_tests/golden-record/my_test_api_client/api/default/post_common_parameters.py

@@ -44,6 +44,13 @@ def sync_detailed(
     client: Client,
     common: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+    Args:
+        common (Union[Unset, None, str]): None:
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         common=common,
@@ -62,6 +69,15 @@ async def asyncio_detailed(
     client: Client,
     common: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        common (Union[Unset, None, str]): None:
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         common=common,

end_to_end_tests/golden-record/my_test_api_client/api/location/get_location_query_optionality.py

@@ -68,6 +68,16 @@ def sync_detailed(
     null_not_required: Union[Unset, None, datetime.datetime] = UNSET,
     not_null_not_required: Union[Unset, None, datetime.datetime] = UNSET,
 ) -> Response[Any]:
+    """
+
+    Args:
+        not_null_required (datetime.datetime): None:
+        null_required (Union[Unset, None, datetime.datetime]): None:
+        null_not_required (Union[Unset, None, datetime.datetime]): None:
+        not_null_not_required (Union[Unset, None, datetime.datetime]): None:
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         not_null_required=not_null_required,
@@ -92,6 +102,18 @@ async def asyncio_detailed(
     null_not_required: Union[Unset, None, datetime.datetime] = UNSET,
     not_null_not_required: Union[Unset, None, datetime.datetime] = UNSET,
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        not_null_required (datetime.datetime): None:
+        null_required (Union[Unset, None, datetime.datetime]): None:
+        null_not_required (Union[Unset, None, datetime.datetime]): None:
+        not_null_not_required (Union[Unset, None, datetime.datetime]): None:
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
         not_null_required=not_null_required,

end_to_end_tests/golden-record/my_test_api_client/api/parameters/delete_common_parameters_overriding_param.py

@@ -46,6 +46,13 @@ def sync_detailed(
     client: Client,
     param_query: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+    Args:
+        param_query (Union[Unset, None, str]): None:
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,
@@ -66,6 +73,15 @@ async def asyncio_detailed(
     client: Client,
     param_query: Union[Unset, None, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        param_query (Union[Unset, None, str]): None:
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,

end_to_end_tests/golden-record/my_test_api_client/api/parameters/get_common_parameters_overriding_param.py

@@ -46,6 +46,13 @@ def sync_detailed(
     client: Client,
     param_query: str = "overriden_in_GET",
 ) -> Response[Any]:
+    """
+
+    Args:
+        param_query (str): None|default: 'overriden_in_GET':
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,
@@ -66,6 +73,15 @@ async def asyncio_detailed(
     client: Client,
     param_query: str = "overriden_in_GET",
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        param_query (str): None|default: 'overriden_in_GET':
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,

end_to_end_tests/golden-record/my_test_api_client/api/parameters/get_same_name_multiple_locations_param.py

@@ -56,6 +56,15 @@ def sync_detailed(
     param_header: Union[Unset, str] = UNSET,
     param_cookie: Union[Unset, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+    Args:
+        param_query (Union[Unset, None, str]): None:
+        param_header (Union[Unset, str]): None,
+        param_cookie (Union[Unset, str]): None,
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,
@@ -80,6 +89,17 @@ async def asyncio_detailed(
     param_header: Union[Unset, str] = UNSET,
     param_cookie: Union[Unset, str] = UNSET,
 ) -> Response[Any]:
+    """
+
+
+    Args:
+        param_query (Union[Unset, None, str]): None:
+        param_header (Union[Unset, str]): None,
+        param_cookie (Union[Unset, str]): None,
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param_path=param_path,
         client=client,

end_to_end_tests/golden-record/my_test_api_client/api/parameters/multiple_path_parameters.py

@@ -46,6 +46,11 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
+    """
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param4=param4,
         param2=param2,
@@ -70,6 +75,13 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
+    """
+
+
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         param4=param4,
         param2=param2,

end_to_end_tests/golden-record/my_test_api_client/api/tag1/get_tag_with_number.py

@@ -36,6 +36,11 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
+    """
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
     )
@@ -52,6 +57,13 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
+    """
+
+
+
+    Returns:
+        Response[Any]
+    """
     kwargs = _get_kwargs(
         client=client,
     )

end_to_end_tests/golden-record/my_test_api_client/api/tests/defaults_tests_defaults_post.py

@@ -119,6 +119,25 @@ def sync_detailed(
     model_prop: ModelWithUnionProperty,
     required_model_prop: ModelWithUnionProperty,
 ) -> Response[Union[Any, HTTPValidationError]]:
+    """
+    Defaults
+
+
+        Args:
+            string_prop (str): None|default: 'the default string':
+            date_prop (datetime.date): None|default: isoparse('1010-10-10').date():
+            float_prop (float): None|default: 3.14:
+            int_prop (int): None|default: 7:
+            boolean_prop (bool): None:
+            list_prop (List[AnEnum]): None:
+            union_prop (Union[float, str]): None|default: 'not a float':
+            union_prop_with_ref (Union[AnEnum, None, Unset, float]): None|default: 0.6:
+            enum_prop (AnEnum): For testing Enums in all the ways they can be used :
+            model_prop (ModelWithUnionProperty): :
+            required_model_prop (ModelWithUnionProperty): :
+        Returns:
+            Response[Union[Any, HTTPValidationError]]
+    """
     kwargs = _get_kwargs(
         client=client,
         string_prop=string_prop,
@@ -157,8 +176,26 @@ def sync(
     model_prop: ModelWithUnionProperty,
     required_model_prop: ModelWithUnionProperty,
 ) -> Optional[Union[Any, HTTPValidationError]]:
-    """ """
-
+    """
+    Defaults
+
+
+
+        Args:
+            string_prop (str): None|default: 'the default string':
+            date_prop (datetime.date): None|default: isoparse('1010-10-10').date():
+            float_prop (float): None|default: 3.14:
+            int_prop (int): None|default: 7:
+            boolean_prop (bool): None:
+            list_prop (List[AnEnum]): None:
+            union_prop (Union[float, str]): None|default: 'not a float':
+            union_prop_with_ref (Union[AnEnum, None, Unset, float]): None|default: 0.6:
+            enum_prop (AnEnum): For testing Enums in all the ways they can be used :
+            model_prop (ModelWithUnionProperty): :
+            required_model_prop (ModelWithUnionProperty): :
+        Returns:
+            Optional[Union[Any, HTTPValidationError]]
+    """
     return sync_detailed(
         client=client,
         string_prop=string_prop,
@@ -190,6 +227,27 @@ async def asyncio_detailed(
     model_prop: ModelWithUnionProperty,
     required_model_prop: ModelWithUnionProperty,
 ) -> Response[Union[Any, HTTPValidationError]]:
+    """
+    Defaults
+
+
+
+        Args:
+            string_prop (str): None|default: 'the default string':
+            date_prop (datetime.date): None|default: isoparse('1010-10-10').date():
+            float_prop (float): None|default: 3.14:
+            int_prop (int): None|default: 7:
+            boolean_prop (bool): None:
+            list_prop (List[AnEnum]): None:
+            union_prop (Union[float, str]): None|default: 'not a float':
+            union_prop_with_ref (Union[AnEnum, None, Unset, float]): None|default: 0.6:
+            enum_prop (AnEnum): For testing Enums in all the ways they can be used :
+            model_prop (ModelWithUnionProperty): :
+            required_model_prop (ModelWithUnionProperty): :
+
+        Returns:
+            Response[Union[Any, HTTPValidationError]]
+    """
     kwargs = _get_kwargs(
         client=client,
         string_prop=string_prop,
@@ -226,8 +284,27 @@ async def asyncio(
     model_prop: ModelWithUnionProperty,
     required_model_prop: ModelWithUnionProperty,
 ) -> Optional[Union[Any, HTTPValidationError]]:
-    """ """
-
+    """
+    Defaults
+
+
+
+
+        Args:
+            string_prop (str): None|default: 'the default string':
+            date_prop (datetime.date): None|default: isoparse('1010-10-10').date():
+            float_prop (float): None|default: 3.14:
+            int_prop (int): None|default: 7:
+            boolean_prop (bool): None:
+            list_prop (List[AnEnum]): None:
+            union_prop (Union[float, str]): None|default: 'not a float':
+            union_prop_with_ref (Union[AnEnum, None, Unset, float]): None|default: 0.6:
+            enum_prop (AnEnum): For testing Enums in all the ways they can be used :
+            model_prop (ModelWithUnionProperty): :
+            required_model_prop (ModelWithUnionProperty): :
+        Returns:
+            Optional[Union[Any, HTTPValidationError]]
+    """
     return (
         await asyncio_detailed(
             client=client,