add redirects from old doc urls

fix urls at readme

README.md

@@ -63,17 +63,17 @@ assert retort.dump(book) == data
   and have different representations for one model.
 * Speed. It is one of the fastest data parsing and serialization libraries.
 * There is no forced model representation, adaptix can adjust to your needs.
-* Support [dozens](https://adaptix.readthedocs.io/en/latest/specific_types_behavior.html) of types,
+* Support [dozens](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/specific-types-behavior.html) of types,
   including different model kinds:
   ``@dataclass``, ``TypedDict``, ``NamedTuple``, and [``attrs``](https://www.attrs.org/en/stable/)
 * Working with self-referenced data types (such as linked lists or trees).
-* Saving [path](https://adaptix.readthedocs.io/en/latest/tutorial.html##error-handling)
+* Saving [path](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#error-handling)
   where an exception is raised (including unexpected errors).
-* Machine-readable [errors](https://adaptix.readthedocs.io/en/latest/tutorial.html#error-handling)
+* Machine-readable [errors](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#error-handling)
   that could be dumped.
 * Support for user-defined generic models.
 * Automatic name style conversion (e.g. `snake_case` to `camelCase`).
-* [Predicate system](https://adaptix.readthedocs.io/en/latest/tutorial.html#predicate-system)
+* [Predicate system](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#predicate-system)
   that allows to concisely and precisely override some behavior.
 * Disabling additional checks to speed up data loading from trusted sources.
 * No auto casting by default. The loader does not try to guess value from plenty of input formats.

docs/conf.py

@@ -51,6 +51,7 @@
     'myst_parser',
     'sphinxext.opengraph',
     'sphinx_better_subsection',
+    'sphinx_reredirects',
 
     # local extensions
     'custom_ext.bench_tools',
@@ -67,15 +68,13 @@
     'changelog/*'
 ]
 
-
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
 html_theme = 'furo'
 
-
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
@@ -125,3 +124,24 @@
 
 pygments_style = "tango"
 pygments_dark_style = "native"
+
+redirects = {
+    "tutorial": "loading-and-dumping/tutorial.html",
+    "extended_usage": "loading-and-dumping/extended-usage.html",
+    "specific_types_behavior": "loading-and-dumping/specific-types-behavior.html",
+
+    "contributing": "reference/contributing.html",
+    "examples": "reference/examples.html",
+
+    **{
+        f"api_reference/{page}": f"../reference/api/{page}.html"
+        for page in [
+            'modules',
+            'adaptix',
+            'adaptix.provider',
+            'adaptix.retort',
+            'adaptix.load_error',
+            'adaptix.struct_trail',
+        ]
+    },
+}

docs/readme_advantages.md

@@ -4,17 +4,17 @@
   and have different representations for one model.
 * Speed. It is one of the fastest data parsing and serialization libraries.
 * There is no forced model representation, adaptix can adjust to your needs.
-* Support [dozens](https://adaptix.readthedocs.io/en/latest/specific_types_behavior.html) of types,
+* Support [dozens](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/specific-types-behavior.html) of types,
   including different model kinds:
   ``@dataclass``, ``TypedDict``, ``NamedTuple``, and [``attrs``](https://www.attrs.org/en/stable/)
 * Working with self-referenced data types (such as linked lists or trees).
-* Saving [path](https://adaptix.readthedocs.io/en/latest/tutorial.html#error-handling)
+* Saving [path](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#error-handling)
   where an exception is raised (including unexpected errors).
-* Machine-readable [errors](https://adaptix.readthedocs.io/en/latest/tutorial.html#error-handling)
+* Machine-readable [errors](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#error-handling)
   that could be dumped.
 * Support for user-defined generic models.
 * Automatic name style conversion (e.g. `snake_case` to `camelCase`).
-* [Predicate system](https://adaptix.readthedocs.io/en/latest/tutorial.html#predicate-system)
+* [Predicate system](https://adaptix.readthedocs.io/en/latest/loading-and-dumping/tutorial.html#predicate-system)
   that allows to concisely and precisely override some behavior.
 * Disabling additional checks to speed up data loading from trusted sources.
 * No auto casting by default. The loader does not try to guess value from plenty of input formats.