Enhance editorial creator settings and creator attributes

server/settings/editorial_creators.py

@@ -7,20 +7,28 @@
 
 class ClipNameTokenizerItem(BaseSettingsModel):
     _layout = "compact"
-    name: str = SettingsField("", title="Tokenizer name")
-    regex: str = SettingsField("", title="Tokenizer regex")
+    name: str = SettingsField("", title="Token name")
+    regex: str = SettingsField("", title="Token regex")
 
 
 class ShotAddTasksItem(BaseSettingsModel):
     _layout = "compact"
-    name: str = SettingsField('', title="Key")
+    name: str = SettingsField('', title="Task Name")
     task_type: str = SettingsField(
         title="Task type",
         enum_resolver=task_types_enum
     )
 
 
 class ShotRenameSubmodel(BaseSettingsModel):
+    """Shot Rename Info
+
+    When enabled, any discovered shots will be renamed based on the `shot rename template`.
+
+    The template supports both the available 
+    [template keys](https://ayon.ynput.io/docs/admin_settings_project_anatomy#available-template-keys) 
+    and tokens defined in the `Clip Name Tokenizer`.
+    """
     enabled: bool = True
     shot_rename_template: str = SettingsField(
         "",
@@ -39,32 +47,43 @@ class ShotRenameSubmodel(BaseSettingsModel):
 class TokenToParentConvertorItem(BaseSettingsModel):
     _layout = "compact"
     # TODO - was 'type' must be renamed in code to `parent_type`
-    parent_type: str = SettingsField(
-        "Project",
-        enum_resolver=lambda: parent_type_enum
-    )
     name: str = SettingsField(
         "",
-        title="Parent token name",
+        title="Token name",
         description="Unique name used in `Parent path template`"
     )
     value: str = SettingsField(
         "",
-        title="Parent token value",
+        title="Token value",
         description="Template where any text, Anatomy keys and Tokens could be used"  # noqa
     )
+    parent_type: str = SettingsField(
+        "Project",
+        title="Folder Type",
+        enum_resolver=lambda: parent_type_enum
+    )
 
 
 class ShotHierarchySubmodel(BaseSettingsModel):
+    """Shot Hierarchy Info
+
+    Shot Hierarchy defines the folder path where each shot will be added.
+    It uses the `Folder path template` to compute each path. 
+    The `Folder path template` supports tokens defined in the `folder path template tokens` setting.
+
+    - Each token in the `Folder path template` represents a folder in the hierarchy.
+    - Each token's value supports both the available 
+    [template keys](https://ayon.ynput.io/docs/admin_settings_project_anatomy#available-template-keys) 
+    and tokens defined in the `Clip Name Tokenizer`.
+    """
     enabled: bool = True
     parents_path: str = SettingsField(
         "",
-        title="Parents path template",
-        description="Using keys from \"Token to parent convertor\" or tokens directly"  # noqa
+        title="Folder path template"
     )
     parents: list[TokenToParentConvertorItem] = SettingsField(
         default_factory=TokenToParentConvertorItem,
-        title="Token to parent convertor"
+        title="Folder path template tokens"
     )
 
 
@@ -94,12 +113,13 @@ class EditorialSimpleCreatorPlugin(BaseSettingsModel):
     )
     clip_name_tokenizer: list[ClipNameTokenizerItem] = SettingsField(
         default_factory=ClipNameTokenizerItem,
-        description=(
-            "Using Regex expression to create tokens. \nThose can be used"
-            " later in \"Shot rename\" creator \nor \"Shot hierarchy\"."
-            "\n\nTokens should be decorated with \"_\" on each side"
-        )
-    )
+        description="""Clip Name Tokenizer Info.
+
+                    Use regex expressions to create tokens.
+                    These tokens will be used later in the `Shot rename` creator or `Shot hierarchy`.
+                    Each token must be enclosed by underscores (`_`).
+                    """
+    )    
     shot_rename: ShotRenameSubmodel = SettingsField(
         title="Shot Rename",
         default_factory=ShotRenameSubmodel
@@ -110,7 +130,8 @@ class EditorialSimpleCreatorPlugin(BaseSettingsModel):
     )
     shot_add_tasks: list[ShotAddTasksItem] = SettingsField(
         title="Add tasks to shot",
-        default_factory=ShotAddTasksItem
+        default_factory=ShotAddTasksItem,
+        description="The following list of tasks will be added to each created shot."
     )
     product_type_presets: list[ProductTypePresetItem] = SettingsField(
         default_factory=list