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/json_sax/parse_error.md

@@ -0,0 +1,28 @@
+# <small>nlohmann::json_sax::</small>parse_error
+
+```cpp
+virtual bool parse_error(std::size_t position,
+                         const std::string& last_token,
+                         const detail::exception& ex) = 0;
+```
+
+A parse error occurred.
+
+## Parameters
+
+`position` (in)
+:   the position in the input where the error occurs
+
+`last_token` (in)
+:   the last read token
+
+`ex` (in)
+:   an exception object describing the error
+
+## Return value
+
+Whether parsing should proceed (**must return `#!cpp false`**).
+
+## Version history
+
+- Added in version 3.2.0.