Docstrings: correct locale activation return type and thread scope (#442)

Author: raghav-sharma-ai

src/humanize/i18n.py

@@ -61,15 +61,16 @@ def activate(
 ) -> gettext_module.NullTranslations:
     """Activate internationalisation.
 
-    Set `locale` as current locale. Search for locale in directory `path`.
+    Set `locale` as the current locale for the calling thread. Search for locale
+    in directory `path`.
 
     Args:
         locale (str | None): Language name, e.g. `en_GB`. If `None`, defaults to no
             translation. Similar to calling ``deactivate()``.
         path (str | pathlib.Path): Path to search for locales.
 
     Returns:
-        dict: Translations.
+        gettext.NullTranslations: Translation object for the selected locale.
 
     Raises:
         FileNotFoundError: If humanize cannot find the locale folder.
@@ -95,7 +96,7 @@ def activate(
 
 
 def deactivate() -> None:
-    """Deactivate internationalisation."""
+    """Deactivate internationalisation for the calling thread."""
     _CURRENT.locale = None