docs: add reference documentation for the client

Author: Midnighter

docs/.pages

@@ -1,4 +1,4 @@
 nav:
-  - Home: index.md
-  - Reference: reference
+  - Overview: index.md
+  - reference
   - ...

docs/index.md

@@ -29,7 +29,7 @@ have an existing workspace that you want to modify locally.
     The `#!python main()` function in each example script creates a more or less involved
     workspace for you.  When you have created a workspace, it is time to upload
     it so that you can create diagrams for it.  You will need to create a
-    `#!python StructurizrClient` instance and its settings. The settings can be provided
+    [`StructurizrClient`][structurizr.api.structurizr_client.StructurizrClient] instance and its settings. The settings can be provided
     as arguments, be read from environment variables, or be provided in a `.env`
     file.
 

docs/reference/.pages

@@ -1,4 +1,4 @@
-title: Reference
+title: API Reference
 
 nav:
   - ...

docs/reference/structurizr.StructurizrClient.md

@@ -0,0 +1,7 @@
+::: structurizr.StructurizrClient
+    selection:
+        members:
+            - get_workspace
+            - put_workspace
+            - lock_workspace
+            - unlock_workspace

docs/reference/structurizr.md

@@ -1,4 +1,4 @@
 mkdocs ~=1.1
 mkdocs-material ~=6.1
 mkdocs-awesome-pages-plugin ~=2.4
-mkdocstrings ~=0.13
+mkdocstrings ~=0.14

docs/requirements.txt

@@ -28,7 +28,10 @@ plugins:
       handlers:
         python:
           rendering:
-            show_source: false
+            show_source: true
+            show_root_heading: false
+            show_root_toc_entry: true
+            show_root_full_path: false
       watch:
         - src/structurizr