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/dump.md

@@ -1,4 +1,4 @@
-# basic_json::dump
+# <small>nlohmann::basic_json::</small>dump
 
 ```cpp
 string_t dump(const int indent = -1,
@@ -7,8 +7,9 @@ string_t dump(const int indent = -1,
               const error_handler_t error_handler = error_handler_t::strict) const;
 ```
 
-Serialization function for JSON values. The function tries to mimic Python's `json.dumps()` function, and currently
-supports its `indent` and `ensure_ascii` parameters.
+Serialization function for JSON values. The function tries to mimic Python's
+[`json.dumps()` function](https://docs.python.org/2/library/json.html#json.dump), and currently  supports its `indent`
+and `ensure_ascii` parameters.
     
 ## Parameters
 
@@ -27,7 +28,7 @@ supports its `indent` and `ensure_ascii` parameters.
 :   how to react on decoding errors; there are three possible values (see [`error_handler_t`](error_handler_t.md):
     `strict` (throws and exception in case a decoding error occurs; default), `replace` (replace invalid UTF-8 sequences
     with U+FFFD), and `ignore` (ignore invalid UTF-8 sequences during serialization; all bytes are copied to the output
-    unchanged).
+    unchanged)).
     
 ## Return value
 
@@ -37,6 +38,11 @@ string containing the serialization of the JSON value
 
 Strong guarantee: if an exception is thrown, there are no changes to any JSON value.
 
+## Exceptions
+
+Throws [`type_error.316`](../../home/exceptions.md#jsonexceptiontype_error316) if a string stored inside the JSON value
+is not UTF-8 encoded and `error_handler` is set to `strict`
+
 ## Complexity
 
 Linear.
@@ -48,7 +54,7 @@ Binary values are serialized as object containing two keys:
 - "bytes": an array of bytes as integers
 - "subtype": the subtype as integer or `#!json null` if the binary has no subtype
 
-## Example
+## Examples
 
 ??? example
 
@@ -64,3 +70,10 @@ Binary values are serialized as object containing two keys:
     ```json
     --8<-- "examples/dump.output"
     ```
+
+## Version history
+
+- Added in version 1.0.0.
+- Indentation character `indent_char`, option `ensure_ascii` and exceptions added in version 3.0.0.
+- Error handlers added in version 3.4.0.
+- Serialization of binary values added in version 3.8.0.