Added new documentation sections

openflexure_microscope/api/example_extensions/doc_example/01_basic_structure.py

@@ -8,12 +8,12 @@ def identify():
     """
     microscope = find_component("org.openflexure.microscope")
 
-    parent_camera = microscope.camera
-    parent_stage = microscope.stage
-
-    response = "My parent camera is {}, and my parent stage is {}.".format(
-        parent_camera, parent_stage
+    response = (
+        f"My name is {microscope.name}. "
+        f"My parent camera is {microscope.camera}, "
+        f"and my parent stage is {microscope.stage}."
     )
+
     return response
 
 

openflexure_microscope/api/example_extensions/doc_example/02_adding_views.py

@@ -2,7 +2,7 @@ from labthings.server.extensions import BaseExtension
 from labthings.server.find import find_component
 from labthings.server.view import View
 
-from labthings.server.decorators import use_args
+from labthings.server.decorators import use_body
 from labthings.server import fields
 
 ## Extension methods
@@ -45,10 +45,10 @@ class ExampleIdentifyView(View):
 
 class ExampleRenameView(View):
     # Expect a request parameter called "name", which is a string. Pass to argument "args".
-    @use_args({"name": fields.String(required=True, example="My Example Microscope")})
-    def post(self, args):
-        # Look for our "name" parameter in the request arguments
-        new_name = args.get("name")
+    @use_body(fields.String(required=True, example="My Example Microscope"))
+    def post(self, body):
+        # Look for our new name in the request body
+        new_name = body
 
         # Find our microscope component
         microscope = find_component("org.openflexure.microscope")