Feature/update documentation

Update documentation

• use rst files instead of markdown
• no more autodoc2, fully replaced with autodoc
• updated the documentation, so less output from Vale or Sphinx (warning-wise)

gso/products/product_blocks/iptrunk.py

@@ -53,7 +53,7 @@ class IptrunkSideBlock(IptrunkSideBlockProvisioning, lifecycle=[SubscriptionLife
 class IptrunkBlockInactive(
     ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITIAL], product_block_name="IptrunkBlock"
 ):
-    """A trunk that's currently inactive, see {class}`IptrunkBlock`."""
+    """A trunk that's currently inactive, see :class:`IptrunkBlock`."""
 
     geant_s_sid: Optional[str] = None
     iptrunk_description: Optional[str] = None
@@ -68,7 +68,7 @@ class IptrunkBlockInactive(
 
 
 class IptrunkBlockProvisioning(IptrunkBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
-    """A trunk that's currently being provisioned, see {class}`IptrunkBlock`."""
+    """A trunk that's currently being provisioned, see :class:`IptrunkBlock`."""
 
     geant_s_sid: Optional[str] = None
     iptrunk_description: Optional[str] = None