document product types

gso/products/product_types/__init__.py

+"""Product types define the different products that are available.
+
+Multiple product blocks may insist on a single product type. In that sense, a product type is a mode general description
+of a product. For example, the product type {class}`Device` must either be a router or a switch, both being separate
+product blocks.
+"""

gso/products/product_types/device.py

@@ -5,6 +5,11 @@ from gso.products.product_blocks.device import DeviceBlock, DeviceBlockInactive,
 
 
 class DeviceType(strEnum):
+    """Enumerator for different device types.
+
+    A device can either be a router or a switch.
+    """
+
     router = "router"
     switch = "switch"