docs(config[find_home_config_files]) document symlink resolution and add param/return sections

why: Docstring did not reflect the behavioral change from adding
`.resolve()`, and was missing NumPy-style parameter/return sections.
what:
- Note that returned paths are resolved through symlinks
- Add Parameters and Returns sections per NumPy docstring standard

Author: tony

src/vcspull/config.py

@@ -349,7 +349,21 @@ def is_valid_config_dict(val: t.Any) -> t.TypeGuard[ConfigDict]:
 def find_home_config_files(
     filetype: list[str] | None = None,
 ) -> list[pathlib.Path]:
-    """Return configs of ``.vcspull.{yaml,json}`` in user's home directory."""
+    """Return configs of ``.vcspull.{yaml,json}`` in user's home directory.
+
+    Paths are resolved through symlinks so callers receive the real
+    filesystem location, consistent with the ``-f`` flag codepath.
+
+    Parameters
+    ----------
+    filetype : list of str, optional
+        File types to search for (default ``["json", "yaml"]``)
+
+    Returns
+    -------
+    list of pathlib.Path
+        Resolved paths to discovered config files
+    """
     if filetype is None:
         filetype = ["json", "yaml"]
     configs: list[pathlib.Path] = []