docs: Minor fixes

Author: pawamoy

docs/extensions/built-in/unpack-typeddict.md

@@ -1,6 +1,6 @@
-# `unpack`
+# `unpack_typeddict`
 
-The `unpack_typeddict` extension adds support for [`Unpack`][typing.Unpack] and [`TypedDict`][typing.TypedDict] from the standard library. When enabled, it will add an `__init__` method to typed dictionaries, and expand `**kwargs: Unpack[...]` (the ellipsis being a [typed dict][typing.TypedDict] class) in function signatures to the relevant parameters, using the typed dict attributes. The extension will also update any Parameters section in the function docstring, to reflect the signature update.
+The `unpack_typeddict` extension adds support for [`Unpack`][typing.Unpack] and [`TypedDict`][typing.TypedDict] from the standard library. When enabled, it will add an `__init__` method to typed dictionaries, and expand `**kwargs: Unpack[...]` (the ellipsis being a [typed dict][typing.TypedDict] class) in function signatures to the relevant parameters, using the typed dict attributes or added signature. The extension will also update any Parameters section in the function docstring, to reflect the signature update.
 
 Example:
 
@@ -34,10 +34,10 @@ With the `unpack_typeddict` extension enabled, the data loaded by Griffe will be
 
 ```python
 class GreetKwargs(TypedDict):
-    # Attributes removed from Griffe data (not from runtime class).
+    # Attributes removed from Griffe data.
 
-    # Added by the `typeddict` extension to Griffe data (not to the runtime class):
-    def __init__(self, name: str, shout: bool) -> None:
+    # Added by the extension to Griffe data (not to the runtime class):
+    def __init__(self, *, name: str, shout: bool) -> None:
         """
         Parameters:
             name: The name of a person to greet.

src/griffe/_internal/extensions/unpack_typeddict.py

@@ -26,7 +26,7 @@ def _update_docstring(func: Function, parameters: Iterable[Parameter], kwparam:
         # Create a parameters section if none exists.
         params_section = DocstringSectionParameters([])
         func.docstring.parsed.append(params_section)
-    # Add entries for all TypedDict attributes.
+    # Add entries for all parameters.
     for param in parameters:
         if param.name != "self":
             params_section.value.append(
@@ -82,7 +82,7 @@ def on_class(self, *, cls: Class, **kwargs: Any) -> None:  # noqa: ARG002
             cls.del_member(attr.name)
 
     def on_function(self, *, func: Function, **kwargs: Any) -> None:  # noqa: ARG002
-        """Replace `**kwargs: Unpack[TypedDict]` parameters with the actual TypedDict attributes."""
+        """Expand `**kwargs: Unpack[TypedDict]` in function signatures."""
         # Find any `**kwargs: Unpack[TypedDict]` parameter.
         for parameter in func.parameters:
             if parameter.kind is ParameterKind.var_keyword: