Tweak docs

HISTORY.md

@@ -14,18 +14,20 @@ Our backwards-compatibility policy can be found [here](https://github.com/python
 
 - **Potentially breaking**: The converters raise {class}`StructureHandlerNotFoundError` more eagerly (on hook creation, instead of on hook use).
   This helps surfacing problems with missing hooks sooner.
-  See [Migrations](https://catt.rs/latest/migrations.html#the-default-structure-hook-fallback-factory) for steps to restore legacy behavior.
+  See [Migrations](https://catt.rs/en/latest/migrations.html#the-default-structure-hook-fallback-factory) for steps to restore legacy behavior.
   ([#577](https://github.com/python-attrs/cattrs/pull/577))
-- Add a [Migrations](https://catt.rs/latest/migrations.html) page, with instructions on migrating changed behavior for each version.
+- Add a [Migrations](https://catt.rs/en/latest/migrations.html) page, with instructions on migrating changed behavior for each version.
   ([#577](https://github.com/python-attrs/cattrs/pull/577))
 - Expose {func}`cattrs.cols.mapping_unstructure_factory` through {mod}`cattrs.cols`.
-- Some `defaultdicts` are now [supported by default](https://catt.rs/latest/), and
+- Some `defaultdicts` are now [supported by default](https://catt.rs/en/latest/defaulthooks.html#defaultdicts), and
   {func}`cattrs.cols.is_defaultdict`{func} and `cattrs.cols.defaultdict_structure_factory` are exposed through {mod}`cattrs.cols`.
   ([#519](https://github.com/python-attrs/cattrs/issues/519) [#588](https://github.com/python-attrs/cattrs/pull/588))
 - Python 3.13 is now supported.
   ([#543](https://github.com/python-attrs/cattrs/pull/543) [#547](https://github.com/python-attrs/cattrs/issues/547))
 - Python 3.8 is no longer supported, as it is end-of-life. Use previous versions on this Python version.
-- Change type of Converter.__init__.unstruct_collection_overrides from Callable to Mapping[type, UnstructureHook] ([#594](https://github.com/python-attrs/cattrs/pull/594).
+  ([#591](https://github.com/python-attrs/cattrs/pull/591))
+- Change type of Converter.__init__.unstruct_collection_overrides from Callable to Mapping[type, UnstructureHook]
+  ([#594](https://github.com/python-attrs/cattrs/pull/594).
 
 ## 24.1.2 (2024-09-22)
 

docs/customizing.md

@@ -155,19 +155,20 @@ Here's an example of using an unstructure hook factory to handle unstructuring [
 [1, 2]
 ```
 
-## Using `cattrs.gen` Generators
+## Using `cattrs.gen` Hook Factories
 
-The {mod}`cattrs.gen` module allows for generating and compiling specialized hooks for unstructuring _attrs_ classes, dataclasses and typed dicts.
+The {mod}`cattrs.gen` module contains [hook factories](#hook-factories) for un/structuring _attrs_ classes, dataclasses and typed dicts.
 The default {class}`Converter <cattrs.Converter>`, upon first encountering one of these types,
-will use the generation functions mentioned here to generate specialized hooks for it,
+will use the hook factories mentioned here to generate specialized hooks for it,
 register the hooks and use them.
 
 One reason for generating these hooks in advance is that they can bypass a lot of _cattrs_ machinery and be significantly faster than normal _cattrs_.
-The hooks are also good building blocks for more complex customizations.
+The hook factories are also good building blocks for more complex customizations.
 
 Another reason is overriding behavior on a per-attribute basis.
 
-Currently, the overrides only support generating dictionary un/structuring hooks (as opposed to tuples), and support `omit_if_default`, `forbid_extra_keys`, `rename` and `omit`.
+Currently, the overrides only support generating dictionary un/structuring hooks (as opposed to tuples),
+and support `omit_if_default`, `forbid_extra_keys`, `rename` and `omit`.
 
 ### `omit_if_default`
 

docs/defaulthooks.md

@@ -185,7 +185,8 @@ Both keys and values are converted.
 
 ### defaultdicts
 
-`defaultdicts` can be structured by default if they can be initialized using their value type hint.
+[`defaultdicts`](https://docs.python.org/3/library/collections.html#collections.defaultdict)
+can be structured by default if they can be initialized using their value type hint.
 Supported types are:
 
 - `collections.defaultdict[K, V]`