code snippet readability

docs/source/index.rst

@@ -16,18 +16,28 @@
 
 .. py-editor::
     :config: pyscript.toml
+    :env: index
 
+    # definition
     import naming
     class NameFileConvention(naming.Name, naming.File):
         config = dict(first=r'\w+', last=r'\w+', number=r'\d+')
 
+    # inspection
     name = NameFileConvention('john doe 07.jpg')
-    print(name.last)
-    print(name.number)
+    print(f"{name.last=}")
+    print(f"{name.number=}")
+
+    # modification
     print(name.get(first='jane', number=99))  # returns new name string
     name.last = 'connor'  # mutates current name
     print(name)
-    name.number = 'not_a_number'
+
+    # validation
+    try:
+        name.number = 'not_a_number'
+    except ValueError as exc:
+        print(f"An error occurred: {exc}")
 
 .. toctree::
     :maxdepth: 2