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_pointer/push_back.md

@@ -0,0 +1,38 @@
+# <small>nlohmann::json_pointer::</small>push_back
+
+```cpp
+void push_back(const std::string& token);
+
+void push_back(std::string&& token);
+```
+
+Append an unescaped token at the end of the reference pointer.
+
+## Parameters
+
+`token` (in)
+:   token to add
+
+## Complexity
+
+Amortized constant.
+
+## Examples
+
+??? example
+
+    The example shows the result of `push_back` for different JSON Pointers.
+     
+    ```cpp
+    --8<-- "examples/json_pointer__push_back.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/json_pointer__push_back.output"
+    ```
+
+## Version history
+
+Added in version 3.6.0.