📝 add more examples

docs/examples/~basic_json.cpp

@@ -0,0 +1,13 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    json* j = new json("Hello, world!");
+    std::cout << *j << std::endl;
+
+    // explicitly call destructor
+    delete j;
+}

docs/examples/~basic_json.output

@@ -0,0 +1 @@
+"Hello, world!"

docs/mkdocs/docs/api/basic_json/~basic_json.md

@@ -14,6 +14,22 @@ No-throw guarantee: this member function never throws exceptions.
 
 Linear.
 
+## Examples
+
+??? example
+
+    The following code shows an example for the destructor.
+     
+    ```cpp
+    --8<-- "examples/~basic_json.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/~basic_json.output"
+    ```
+
 ## Version history
 
 - Added in version 1.0.0.