Consolidate documentation (#3071)

* 🔥 consolidate documentation
* ♻️ overwork std specializations
* 🚚 move images files to mkdocs
* ♻️ fix URLs
* 🔧 tweak MkDocs configuration
* 🔧 add namespaces
* 📝 document deprecations
* 📝 document documentation generation
* 🚸 improve search
* 🚸 add examples
* 🚧 start adding documentation for macros
* 📝 add note for https://github.com/nlohmann/json/issues/874#issuecomment-1001699139
* 📝 overwork example handling
* 📝 fix Markdown tables

doc/mkdocs/docs/api/basic_json/out_of_range.md

@@ -1,4 +1,4 @@
-# basic_json::out_of_range
+# <small>nlohmann::basic_json::</small>out_of_range
 
 ```cpp
 class out_of_range : public exception;
@@ -7,7 +7,7 @@ class out_of_range : public exception;
 This exception is thrown in case a library function is called on an input parameter that exceeds the expected range, for
 instance in case of array indices or nonexisting object keys.
 
-Exceptions have ids 4xx.
+Exceptions have ids 4xx (see [list of out-of-range errors](../../home/exceptions.md#out-of-range)).
 
 ```plantuml
 std::exception <|-- basic_json::exception
@@ -39,7 +39,7 @@ class basic_json::out_of_range #FFFF00 {}
 
 - **id** - the id of the exception
 
-## Example
+## Examples
 
 ??? example
 
@@ -55,6 +55,14 @@ class basic_json::out_of_range #FFFF00 {}
     --8<-- "examples/out_of_range.output"
     ```
 
+## See also
+
+- [List of out-of-range errors](../../home/exceptions.md#out-of-range)
+- [`parse_error`](parse_error.md) for exceptions indicating a parse error
+- [`invalid_iterator`](invalid_iterator.md) for exceptions indicating errors with iterators
+- [`type_error`](type_error.md) for exceptions indicating executing a member function with a wrong type
+- [`other_error`](other_error.md) for exceptions indicating other library errors
+
 ## Version history
 
 - Since version 3.0.0.