Docs WIP

Author: lgarber-akamai

linode_api4/objects/linode.py

@@ -664,6 +664,10 @@ class MigrationType:
 
 
 class InterfaceGeneration(StrEnum):
+    """
+    A string enum representing which interface generation a Linode is using.
+    """
+
     LEGACY_CONFIG = "legacy_config"
     LINODE = "linode"
 
@@ -1896,7 +1900,22 @@ def interface_create(
         ] = None,
         vpc: Optional[Union[Dict[str, Any], LinodeInterfaceVPCOptions]] = None,
         **kwargs,
-    ):
+    ) -> LinodeInterface:
+        """
+         Creates a new interface under this Linode.
+
+         :param firewall: The firewall this interface should be assigned to.
+         :param default_route: The desired default route configuration of the new interface.
+         :param public: The public-specific configuration of the new interface.
+                        If set, the new instance will be a public interface.
+         :param vlan: The VLAN-specific configuration of the new interface.
+                      If set, the new instance will be a VLAN interface.
+         :param vpc: The VPC-specific configuration of the new interface.
+                        If set, the new instance will be a VPC interface.
+
+        :returns: The newly created Linode Interface.
+        """
+
         params = {
             "firewall_id": firewall,
             "default_route": default_route,
@@ -1922,6 +1941,7 @@ def interface_create(
 
     @property
     def interfaces_settings(self):
+
         # NOTE: We do not implement this as a Property because Property does
         # not currently have a mechanism for 1:1 sub-entities.
         result = self._client.get(

linode_api4/objects/linode_interfaces.py

@@ -32,7 +32,7 @@ class LinodeInterfacesSettingsDefaultRoute(JSONObject):
 
 
 class LinodeInterfacesSettings(Base):
-    """"
+    """ "
     The settings for a Linode's network interfaces.
 
     API Documentation: Not yet available.