datocms-plugin-sdk 2.0.1 → 2.0.3

package/src/manifest.ts

@@ -5,8 +5,8 @@ export const manifest: Manifest = {
     validateManualFieldExtensionParameters: {
       name: 'validateManualFieldExtensionParameters',
       comment: {
-        comment:
-          'This function will be called each time the configuration object changes. It\nmust return an object containing possible validation errors',
+        markdownText:
+          'This function will be called each time the configuration object changes. It\nmust return an object containing possible validation errors.',
         tag: 'manualFieldExtensions',
       },
       nonCtxArguments: [
@@ -28,7 +28,7 @@ export const manifest: Manifest = {
     uploadsDropdownActions: {
       name: 'uploadsDropdownActions',
       comment: {
-        comment:
+        markdownText:
           'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple assets in the Media Area for batch operations, or\n* opens up a specific asset from the Media Area.\n\nThe `executeUploadsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
         tag: 'dropdownActions',
       },
@@ -47,8 +47,8 @@ export const manifest: Manifest = {
     uploadSidebars: {
       name: 'uploadSidebars',
       comment: {
-        comment:
-          'Use this function to declare new sidebar to be shown when the user opens\nup an asset in the Media Area',
+        markdownText:
+          'Use this function to declare new sidebar to be shown when the user opens\nup an asset in the Media Area.',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [],
@@ -66,8 +66,8 @@ export const manifest: Manifest = {
     uploadSidebarPanels: {
       name: 'uploadSidebarPanels',
       comment: {
-        comment:
-          'Use this function to declare new sidebar panels to be shown when the user\nopens up an asset in the Media Area',
+        markdownText:
+          'Use this function to declare new sidebar panels to be shown when the user\nopens up an asset in the Media Area.',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [],
@@ -85,8 +85,8 @@ export const manifest: Manifest = {
     settingsAreaSidebarItemGroups: {
       name: 'settingsAreaSidebarItemGroups',
       comment: {
-        comment:
-          'Use this function to declare new navigation sections in the Settings Area\nsidebar',
+        markdownText:
+          'Use this function to declare new navigation sections in the Settings Area\nsidebar.',
         tag: 'pages',
       },
       nonCtxArguments: [],
@@ -104,8 +104,8 @@ export const manifest: Manifest = {
     renderUploadSidebarPanel: {
       name: 'renderUploadSidebarPanel',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a sidebar panel\n(see the `uploadSidebarPanels` function)',
+        markdownText:
+          'This function will be called when the plugin needs to render a sidebar panel\n(see the `uploadSidebarPanels` hook).',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -121,8 +121,8 @@ export const manifest: Manifest = {
             items: {
               sidebarPaneId: {
                 comment: {
-                  comment:
-                    'The ID of the sidebar panel that needs to be rendered',
+                  markdownText:
+                    'The ID of the sidebar panel that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -132,8 +132,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The arbitrary `parameters` of the panel declared in the\n`uploadSidebarPanels` function',
+                  markdownText:
+                    'The arbitrary `parameters` of the panel declared in the\n`uploadSidebarPanels` function.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -143,7 +143,7 @@ export const manifest: Manifest = {
               },
               upload: {
                 comment: {
-                  comment: 'The active asset',
+                  markdownText: 'The active asset.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -165,8 +165,8 @@ export const manifest: Manifest = {
     renderUploadSidebar: {
       name: 'renderUploadSidebar',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a sidebar (see\nthe `uploadSidebars` function)',
+        markdownText:
+          'This function will be called when the plugin needs to render a sidebar (see\nthe `uploadSidebars` hook).',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -182,7 +182,8 @@ export const manifest: Manifest = {
             items: {
               sidebarId: {
                 comment: {
-                  comment: 'The ID of the sidebar that needs to be rendered',
+                  markdownText:
+                    'The ID of the sidebar that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -192,8 +193,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The arbitrary `parameters` of the declared in the `uploadSidebars`\nfunction',
+                  markdownText:
+                    'The arbitrary `parameters` of the declared in the `uploadSidebars`\nfunction.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -203,7 +204,7 @@ export const manifest: Manifest = {
               },
               upload: {
                 comment: {
-                  comment: 'The active asset',
+                  markdownText: 'The active asset.',
                 },
                 location: {
                   filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -225,8 +226,8 @@ export const manifest: Manifest = {
     renderPage: {
       name: 'renderPage',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a specific\npage (see the `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and\n`contentAreaSidebarItems` functions)',
+        markdownText:
+          'This function will be called when the plugin needs to render a specific\npage (see the `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and\n`contentAreaSidebarItems` functions).',
         tag: 'pages',
       },
       nonCtxArguments: [
@@ -242,7 +243,7 @@ export const manifest: Manifest = {
             items: {
               pageId: {
                 comment: {
-                  comment: 'The ID of the page that needs to be rendered',
+                  markdownText: 'The ID of the page that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderPage.ts',
@@ -264,8 +265,8 @@ export const manifest: Manifest = {
     renderModal: {
       name: 'renderModal',
       comment: {
-        comment:
-          'This function will be called when the plugin requested to open a modal (see\nthe `openModal` function)',
+        markdownText:
+          'This function will be called when the plugin requested to open a modal (see\nthe `openModal` hook).',
         tag: 'modals',
       },
       nonCtxArguments: [
@@ -281,7 +282,8 @@ export const manifest: Manifest = {
             items: {
               modalId: {
                 comment: {
-                  comment: 'The ID of the modal that needs to be rendered',
+                  markdownText:
+                    'The ID of the modal that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderModal.ts',
@@ -291,8 +293,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The arbitrary `parameters` of the modal declared in the `openModal`\nfunction',
+                  markdownText:
+                    'The arbitrary `parameters` of the modal declared in the `openModal`\nfunction.',
                 },
                 location: {
                   filePath: 'src/hooks/renderModal.ts',
@@ -308,8 +310,8 @@ export const manifest: Manifest = {
             items: {
               resolve: {
                 comment: {
-                  comment:
-                    'A function to be called by the plugin to close the modal. The `openModal`\ncall will be resolved with the passed return value',
+                  markdownText:
+                    'A function to be called by the plugin to close the modal. The `openModal`\ncall will be resolved with the passed return value.',
                   example:
                     "const returnValue = prompt(\n  'Please specify the value to return to the caller:',\n  'success',\n);\n\nawait ctx.resolve(returnValue);",
                 },
@@ -344,8 +346,8 @@ export const manifest: Manifest = {
             items: {
               fieldExtensionId: {
                 comment: {
-                  comment:
-                    'The ID of the field extension for which we need to render the parameters\nform',
+                  markdownText:
+                    'The ID of the field extension for which we need to render the parameters\nform.',
                 },
                 location: {
                   filePath:
@@ -356,8 +358,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The current value of the parameters (you can change the value with the\n`setParameters` function)',
+                  markdownText:
+                    'The current value of the parameters (you can change the value with the\n`setParameters` hook).',
                 },
                 location: {
                   filePath:
@@ -368,8 +370,8 @@ export const manifest: Manifest = {
               },
               errors: {
                 comment: {
-                  comment:
-                    'The current validation errors for the parameters (you can set them\nimplementing the `validateManualFieldExtensionParameters` function)',
+                  markdownText:
+                    'The current validation errors for the parameters (you can set them\nimplementing the `validateManualFieldExtensionParameters` hook).',
                 },
                 location: {
                   filePath:
@@ -380,7 +382,8 @@ export const manifest: Manifest = {
               },
               pendingField: {
                 comment: {
-                  comment: 'The field entity that is being edited in the form',
+                  markdownText:
+                    'The field entity that is being edited in the form.',
                 },
                 location: {
                   filePath:
@@ -391,7 +394,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the field being edited',
+                  markdownText: 'The model for the field being edited.',
                 },
                 location: {
                   filePath:
@@ -408,7 +411,7 @@ export const manifest: Manifest = {
             items: {
               setParameters: {
                 comment: {
-                  comment: 'Sets a new value for the parameters',
+                  markdownText: 'Sets a new value for the parameters.',
                   example: "await ctx.setParameters({ color: '#ff0000' });",
                 },
                 location: {
@@ -431,8 +434,8 @@ export const manifest: Manifest = {
     renderItemFormSidebarPanel: {
       name: 'renderItemFormSidebarPanel',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a sidebar panel\n(see the `itemFormSidebarPanels` function)',
+        markdownText:
+          'This function will be called when the plugin needs to render a sidebar panel\n(see the `itemFormSidebarPanels` hook).',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -445,10 +448,15 @@ export const manifest: Manifest = {
         type: 'SelfResizingPluginFrameCtx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -458,8 +466,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -469,7 +477,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -479,7 +487,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -489,7 +497,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -499,8 +508,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -510,8 +519,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -521,13 +530,14 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
@@ -535,8 +545,8 @@ export const manifest: Manifest = {
             items: {
               sidebarPaneId: {
                 comment: {
-                  comment:
-                    'The ID of the sidebar panel that needs to be rendered',
+                  markdownText:
+                    'The ID of the sidebar panel that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemFormSidebarPanel.ts',
@@ -546,8 +556,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The arbitrary `parameters` of the panel declared in the\n`itemFormSidebarPanels` function',
+                  markdownText:
+                    'The arbitrary `parameters` of the panel declared in the\n`itemFormSidebarPanels` function.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemFormSidebarPanel.ts',
@@ -560,89 +570,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -659,8 +676,8 @@ export const manifest: Manifest = {
     renderItemFormSidebar: {
       name: 'renderItemFormSidebar',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a sidebar (see\nthe `itemFormSidebars` function)',
+        markdownText:
+          'This function will be called when the plugin needs to render a sidebar (see\nthe `itemFormSidebars` hook).',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -673,10 +690,15 @@ export const manifest: Manifest = {
         type: 'ImposedSizePluginFrameCtx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -686,8 +708,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -697,7 +719,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -707,7 +729,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -717,7 +739,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -727,8 +750,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -738,8 +761,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -749,13 +772,14 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
@@ -763,7 +787,8 @@ export const manifest: Manifest = {
             items: {
               sidebarId: {
                 comment: {
-                  comment: 'The ID of the sidebar that needs to be rendered',
+                  markdownText:
+                    'The ID of the sidebar that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemFormSidebar.ts',
@@ -773,8 +798,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment:
-                    'The arbitrary `parameters` of the declared in the `itemFormSidebars`\nfunction',
+                  markdownText:
+                    'The arbitrary `parameters` of the declared in the `itemFormSidebars`\nfunction.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemFormSidebar.ts',
@@ -787,89 +812,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -886,7 +918,7 @@ export const manifest: Manifest = {
     renderItemFormOutlet: {
       name: 'renderItemFormOutlet',
       comment: {
-        comment:
+        markdownText:
           'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
         tag: 'outlets',
       },
@@ -900,10 +932,15 @@ export const manifest: Manifest = {
         type: 'SelfResizingPluginFrameCtx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -913,8 +950,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -924,7 +961,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -934,7 +971,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -944,7 +981,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -954,8 +992,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -965,8 +1003,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -976,13 +1014,14 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
@@ -990,7 +1029,8 @@ export const manifest: Manifest = {
             items: {
               itemFormOutletId: {
                 comment: {
-                  comment: 'The ID of the outlet that needs to be rendered',
+                  markdownText:
+                    'The ID of the outlet that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemFormOutlet.ts',
@@ -1003,89 +1043,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -1102,7 +1149,7 @@ export const manifest: Manifest = {
     renderItemCollectionOutlet: {
       name: 'renderItemCollectionOutlet',
       comment: {
-        comment:
+        markdownText:
           'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
         tag: 'outlets',
       },
@@ -1119,7 +1166,8 @@ export const manifest: Manifest = {
             items: {
               itemCollectionOutletId: {
                 comment: {
-                  comment: 'The ID of the outlet that needs to be rendered',
+                  markdownText:
+                    'The ID of the outlet that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderItemCollectionOutlet.ts',
@@ -1141,8 +1189,8 @@ export const manifest: Manifest = {
     renderFieldExtension: {
       name: 'renderFieldExtension',
       comment: {
-        comment:
-          'This function will be called when the plugin needs to render a field\nextension (see the `manualFieldExtensions` and `overrideFieldExtensions`\nfunctions)',
+        markdownText:
+          'This function will be called when the plugin needs to render a field\nextension (see the `manualFieldExtensions` and `overrideFieldExtensions`\nfunctions).',
         tag: 'forcedFieldExtensions',
       },
       nonCtxArguments: [
@@ -1155,10 +1203,15 @@ export const manifest: Manifest = {
         type: 'SelfResizingPluginFrameCtx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1168,8 +1221,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1179,7 +1232,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1189,7 +1242,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1199,7 +1252,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1209,8 +1263,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1220,8 +1274,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1231,69 +1285,76 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
           {
+            name: 'FieldAdditionalProperties',
+            comment: {
+              markdownText:
+                'These information describe the current state of the field where this plugin\nis applied to.',
+            },
             items: {
               disabled: {
                 comment: {
-                  comment: 'Whether the field is currently disabled or not',
+                  markdownText:
+                    'Whether the field is currently disabled or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 8,
+                  lineNumber: 12,
                 },
                 type: 'boolean',
               },
               fieldPath: {
                 comment: {
-                  comment:
-                    'The path in the `formValues` object where to find the current value for the\nfield',
+                  markdownText:
+                    'The path in the `formValues` object where to find the current value for the\nfield.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 13,
+                  lineNumber: 17,
                 },
                 type: 'string',
               },
               field: {
                 comment: {
-                  comment:
-                    'The field where the field extension is installed to',
+                  markdownText:
+                    'The field where the field extension is installed to.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 15,
+                  lineNumber: 19,
                 },
                 type: 'Field',
               },
               parentField: {
                 comment: {
-                  comment:
-                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                  markdownText:
+                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 20,
+                  lineNumber: 24,
                 },
                 type: 'Field | undefined',
               },
               block: {
                 comment: {
-                  comment:
+                  markdownText:
                     'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 26,
+                  lineNumber: 30,
                 },
                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
               },
@@ -1303,8 +1364,8 @@ export const manifest: Manifest = {
             items: {
               fieldExtensionId: {
                 comment: {
-                  comment:
-                    'The ID of the field extension that needs to be rendered',
+                  markdownText:
+                    'The ID of the field extension that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderFieldExtension.ts',
@@ -1314,7 +1375,8 @@ export const manifest: Manifest = {
               },
               parameters: {
                 comment: {
-                  comment: 'The arbitrary `parameters` of the field extension',
+                  markdownText:
+                    'The arbitrary `parameters` of the field extension.',
                 },
                 location: {
                   filePath: 'src/hooks/renderFieldExtension.ts',
@@ -1327,89 +1389,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -1426,8 +1495,8 @@ export const manifest: Manifest = {
     renderConfigScreen: {
       name: 'renderConfigScreen',
       comment: {
-        comment:
-          "This function will be called when the plugin needs to render the plugin's\nconfiguration form",
+        markdownText:
+          "This function will be called when the plugin needs to render the plugin's\nconfiguration form.",
         tag: 'configScreen',
       },
       nonCtxArguments: [],
@@ -1445,7 +1514,7 @@ export const manifest: Manifest = {
     renderAssetSource: {
       name: 'renderAssetSource',
       comment: {
-        comment:
+        markdownText:
           "This function will be called when the user selects one of the plugin's\nasset sources to upload a new media file.",
         tag: 'assetSources',
       },
@@ -1462,8 +1531,8 @@ export const manifest: Manifest = {
             items: {
               assetSourceId: {
                 comment: {
-                  comment:
-                    'The ID of the assetSource that needs to be rendered',
+                  markdownText:
+                    'The ID of the assetSource that needs to be rendered.',
                 },
                 location: {
                   filePath: 'src/hooks/renderAssetSource.ts',
@@ -1479,7 +1548,7 @@ export const manifest: Manifest = {
             items: {
               select: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Function to be called when the user selects the asset: it will trigger the\ncreation of a new `Upload` that will be added in the Media Area.',
                   example:
                     "await ctx.select({\n  resource: {\n    url: 'https://images.unsplash.com/photo-1416339306562-f3d12fefd36f',\n    filename: 'man-drinking-coffee.jpg',\n  },\n  copyright: 'Royalty free (Unsplash)',\n  author: 'Jeff Sheldon',\n  notes: 'A man drinking a coffee',\n  tags: ['man', 'coffee'],\n});",
@@ -1503,8 +1572,8 @@ export const manifest: Manifest = {
     overrideFieldExtensions: {
       name: 'overrideFieldExtensions',
       comment: {
-        comment:
-          'Use this function to automatically force one or more field extensions to a\nparticular field',
+        markdownText:
+          'Use this function to automatically force one or more field extensions to a\nparticular field.',
         tag: 'forcedFieldExtensions',
       },
       nonCtxArguments: [
@@ -1539,7 +1608,7 @@ export const manifest: Manifest = {
     onBoot: {
       name: 'onBoot',
       comment: {
-        comment:
+        markdownText:
           'This function will be called once at boot time and can be used to perform\nie. some initial integrity checks on the configuration.',
         tag: 'boot',
       },
@@ -1558,8 +1627,8 @@ export const manifest: Manifest = {
     onBeforeItemsUnpublish: {
       name: 'onBeforeItemsUnpublish',
       comment: {
-        comment:
-          'This function will be called before unpublishing records. You can stop the\naction by returning `false`',
+        markdownText:
+          'This function will be called before unpublishing records. You can stop the\naction by returning `false`.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1582,8 +1651,8 @@ export const manifest: Manifest = {
     onBeforeItemsPublish: {
       name: 'onBeforeItemsPublish',
       comment: {
-        comment:
-          'This function will be called before publishing records. You can stop the\naction by returning `false`',
+        markdownText:
+          'This function will be called before publishing records. You can stop the\naction by returning `false`.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1606,8 +1675,8 @@ export const manifest: Manifest = {
     onBeforeItemsDestroy: {
       name: 'onBeforeItemsDestroy',
       comment: {
-        comment:
-          'This function will be called before destroying records. You can stop the\naction by returning `false`',
+        markdownText:
+          'This function will be called before destroying records. You can stop the\naction by returning `false`.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1630,8 +1699,8 @@ export const manifest: Manifest = {
     onBeforeItemUpsert: {
       name: 'onBeforeItemUpsert',
       comment: {
-        comment:
-          'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`',
+        markdownText:
+          'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1654,8 +1723,8 @@ export const manifest: Manifest = {
     manualFieldExtensions: {
       name: 'manualFieldExtensions',
       comment: {
-        comment:
-          'Use this function to declare new field extensions that users will be able\nto install manually in some field',
+        markdownText:
+          'Use this function to declare new field extensions that users will be able\nto install manually in some field.',
         tag: 'manualFieldExtensions',
       },
       nonCtxArguments: [],
@@ -1673,8 +1742,8 @@ export const manifest: Manifest = {
     mainNavigationTabs: {
       name: 'mainNavigationTabs',
       comment: {
-        comment:
-          'Use this function to declare new tabs you want to add in the top-bar of the\nUI',
+        markdownText:
+          'Use this function to declare new tabs you want to add in the top-bar of the\nUI.',
         tag: 'pages',
       },
       nonCtxArguments: [],
@@ -1692,7 +1761,7 @@ export const manifest: Manifest = {
     itemsDropdownActions: {
       name: 'itemsDropdownActions',
       comment: {
-        comment:
+        markdownText:
           'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple records in the collection view for batch operations, or\n* starts editing a specific record.\n\nThe `executeItemsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
         tag: 'dropdownActions',
       },
@@ -1728,8 +1797,8 @@ export const manifest: Manifest = {
     itemFormSidebars: {
       name: 'itemFormSidebars',
       comment: {
-        comment:
-          'Use this function to declare new sidebar to be shown when the user edits\nrecords of a particular model',
+        markdownText:
+          'Use this function to declare new sidebar to be shown when the user edits\nrecords of a particular model.',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -1752,8 +1821,8 @@ export const manifest: Manifest = {
     itemFormSidebarPanels: {
       name: 'itemFormSidebarPanels',
       comment: {
-        comment:
-          'Use this function to declare new sidebar panels to be shown when the user\nedits records of a particular model',
+        markdownText:
+          'Use this function to declare new sidebar panels to be shown when the user\nedits records of a particular model.',
         tag: 'sidebarPanels',
       },
       nonCtxArguments: [
@@ -1776,8 +1845,8 @@ export const manifest: Manifest = {
     itemFormOutlets: {
       name: 'itemFormOutlets',
       comment: {
-        comment:
-          "Use this function to declare custom outlets to be shown at the top of the\nrecord's editing page",
+        markdownText:
+          "Use this function to declare custom outlets to be shown at the top of the\nrecord's editing page.",
         tag: 'outlets',
       },
       nonCtxArguments: [
@@ -1800,7 +1869,7 @@ export const manifest: Manifest = {
     itemFormDropdownActions: {
       name: 'itemFormDropdownActions',
       comment: {
-        comment:
+        markdownText:
           'Use this function to define custom actions (or groups of actions) to be\ndisplayed at when editing a particular record.\n\nThe `executeItemFormDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
         tag: 'dropdownActions',
       },
@@ -1814,10 +1883,15 @@ export const manifest: Manifest = {
         type: 'Ctx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1827,8 +1901,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1838,7 +1912,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1848,7 +1922,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1858,7 +1932,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1868,8 +1943,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1879,8 +1954,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1890,13 +1965,14 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
@@ -1912,8 +1988,8 @@ export const manifest: Manifest = {
     itemCollectionOutlets: {
       name: 'itemCollectionOutlets',
       comment: {
-        comment:
-          'Use this function to declare custom outlets to be shown at the top of a\ncollection of records of a particular model',
+        markdownText:
+          'Use this function to declare custom outlets to be shown at the top of a\ncollection of records of a particular model.',
         tag: 'outlets',
       },
       nonCtxArguments: [
@@ -1936,8 +2012,8 @@ export const manifest: Manifest = {
     initialLocationQueryForItemSelector: {
       name: 'initialLocationQueryForItemSelector',
       comment: {
-        comment:
-          'Use this function to customize the initial filters when opening a record\nselector via a "Single link" or "Multiple links" field',
+        markdownText:
+          'Use this function to customize the initial filters when opening a record\nselector via a "Single link" or "Multiple links" field.',
         tag: 'locationQuery',
       },
       nonCtxArguments: [
@@ -1965,7 +2041,7 @@ export const manifest: Manifest = {
     fieldDropdownActions: {
       name: 'fieldDropdownActions',
       comment: {
-        comment:
+        markdownText:
           'Use this function to define custom actions (or groups of actions) to be\ndisplayed at the individual field level in the record editing form.\n\nThe `executeFieldDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
         tag: 'dropdownActions',
       },
@@ -1979,10 +2055,15 @@ export const manifest: Manifest = {
         type: 'Ctx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1992,8 +2073,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2003,7 +2084,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2013,7 +2094,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2023,7 +2104,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2033,8 +2115,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2044,8 +2126,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2055,69 +2137,76 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
           {
+            name: 'FieldAdditionalProperties',
+            comment: {
+              markdownText:
+                'These information describe the current state of the field where this plugin\nis applied to.',
+            },
             items: {
               disabled: {
                 comment: {
-                  comment: 'Whether the field is currently disabled or not',
+                  markdownText:
+                    'Whether the field is currently disabled or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 8,
+                  lineNumber: 12,
                 },
                 type: 'boolean',
               },
               fieldPath: {
                 comment: {
-                  comment:
-                    'The path in the `formValues` object where to find the current value for the\nfield',
+                  markdownText:
+                    'The path in the `formValues` object where to find the current value for the\nfield.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 13,
+                  lineNumber: 17,
                 },
                 type: 'string',
               },
               field: {
                 comment: {
-                  comment:
-                    'The field where the field extension is installed to',
+                  markdownText:
+                    'The field where the field extension is installed to.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 15,
+                  lineNumber: 19,
                 },
                 type: 'Field',
               },
               parentField: {
                 comment: {
-                  comment:
-                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                  markdownText:
+                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 20,
+                  lineNumber: 24,
                 },
                 type: 'Field | undefined',
               },
               block: {
                 comment: {
-                  comment:
+                  markdownText:
                     'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 26,
+                  lineNumber: 30,
                 },
                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
               },
@@ -2135,7 +2224,7 @@ export const manifest: Manifest = {
     executeUploadsDropdownAction: {
       name: 'executeUploadsDropdownAction',
       comment: {
-        comment:
+        markdownText:
           'Use this function to execute a particular dropdown action defined via\nthe `uploadsDropdownActions()` hook.',
         tag: 'dropdownActions',
       },
@@ -2175,7 +2264,7 @@ export const manifest: Manifest = {
     executeItemsDropdownAction: {
       name: 'executeItemsDropdownAction',
       comment: {
-        comment:
+        markdownText:
           'Use this function to execute a particular dropdown action defined via\nthe `itemsDropdownActions()` hook.',
         tag: 'dropdownActions',
       },
@@ -2215,7 +2304,7 @@ export const manifest: Manifest = {
     executeItemFormDropdownAction: {
       name: 'executeItemFormDropdownAction',
       comment: {
-        comment:
+        markdownText:
           'Use this function to execute a particular dropdown action defined via\nthe `itemFormDropdownActions()` hook.',
         tag: 'dropdownActions',
       },
@@ -2229,10 +2318,15 @@ export const manifest: Manifest = {
         type: 'Ctx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2242,8 +2336,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2253,7 +2347,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2263,7 +2357,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2273,7 +2367,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2283,8 +2378,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2294,8 +2389,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2305,13 +2400,14 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
@@ -2329,89 +2425,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -2428,7 +2531,7 @@ export const manifest: Manifest = {
     executeFieldDropdownAction: {
       name: 'executeFieldDropdownAction',
       comment: {
-        comment:
+        markdownText:
           'Use this function to execute a particular dropdown action defined via\nthe `fieldDropdownActions()` hook.',
         tag: 'dropdownActions',
       },
@@ -2442,10 +2545,15 @@ export const manifest: Manifest = {
         type: 'Ctx',
         additionalProperties: [
           {
+            name: 'ItemFormAdditionalProperties',
+            comment: {
+              markdownText:
+                "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+            },
             items: {
               locale: {
                 comment: {
-                  comment: 'The currently active locale for the record',
+                  markdownText: 'The currently active locale for the record.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2455,8 +2563,8 @@ export const manifest: Manifest = {
               },
               item: {
                 comment: {
-                  comment:
-                    'If an already persisted record is being edited, returns the full record\nentity',
+                  markdownText:
+                    'If an already persisted record is being edited, returns the full record\nentity.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2466,7 +2574,7 @@ export const manifest: Manifest = {
               },
               itemType: {
                 comment: {
-                  comment: 'The model for the record being edited',
+                  markdownText: 'The model for the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2476,7 +2584,7 @@ export const manifest: Manifest = {
               },
               formValues: {
                 comment: {
-                  comment: 'The complete internal form state',
+                  markdownText: 'The complete internal form state.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2486,7 +2594,8 @@ export const manifest: Manifest = {
               },
               itemStatus: {
                 comment: {
-                  comment: 'The current status of the record being edited',
+                  markdownText:
+                    'The current status of the record being edited.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2496,8 +2605,8 @@ export const manifest: Manifest = {
               },
               isSubmitting: {
                 comment: {
-                  comment:
-                    'Whether the form is currently submitting itself or not',
+                  markdownText:
+                    'Whether the form is currently submitting itself or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2507,8 +2616,8 @@ export const manifest: Manifest = {
               },
               isFormDirty: {
                 comment: {
-                  comment:
-                    'Whether the form has some non-persisted changes or not',
+                  markdownText:
+                    'Whether the form has some non-persisted changes or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2518,69 +2627,76 @@ export const manifest: Manifest = {
               },
               blocksAnalysis: {
                 comment: {
-                  comment: 'Current number of blocks present in form state',
+                  markdownText:
+                    'Provides information on how many blocks are currently present in the form.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
                   lineNumber: 29,
                 },
-                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                type: 'BlocksAnalysis',
               },
             },
           },
           {
+            name: 'FieldAdditionalProperties',
+            comment: {
+              markdownText:
+                'These information describe the current state of the field where this plugin\nis applied to.',
+            },
             items: {
               disabled: {
                 comment: {
-                  comment: 'Whether the field is currently disabled or not',
+                  markdownText:
+                    'Whether the field is currently disabled or not.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 8,
+                  lineNumber: 12,
                 },
                 type: 'boolean',
               },
               fieldPath: {
                 comment: {
-                  comment:
-                    'The path in the `formValues` object where to find the current value for the\nfield',
+                  markdownText:
+                    'The path in the `formValues` object where to find the current value for the\nfield.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 13,
+                  lineNumber: 17,
                 },
                 type: 'string',
               },
               field: {
                 comment: {
-                  comment:
-                    'The field where the field extension is installed to',
+                  markdownText:
+                    'The field where the field extension is installed to.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 15,
+                  lineNumber: 19,
                 },
                 type: 'Field',
               },
               parentField: {
                 comment: {
-                  comment:
-                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                  markdownText:
+                    'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 20,
+                  lineNumber: 24,
                 },
                 type: 'Field | undefined',
               },
               block: {
                 comment: {
-                  comment:
+                  markdownText:
                     'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/field.ts',
-                  lineNumber: 26,
+                  lineNumber: 30,
                 },
                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
               },
@@ -2600,89 +2716,96 @@ export const manifest: Manifest = {
         ],
         additionalMethods: [
           {
+            name: 'ItemFormAdditionalMethods',
+            comment: {
+              markdownText:
+                "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+            },
             items: {
               toggleField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 65,
+                  lineNumber: 68,
                 },
                 type: '(path: string, show: boolean) => Promise<void>',
               },
               disableField: {
                 comment: {
-                  comment: 'Disables/re-enables a specific field in the form',
+                  markdownText:
+                    'Disables/re-enables a specific field in the form.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 80,
+                  lineNumber: 83,
                 },
                 type: '(path: string, disable: boolean) => Promise<void>',
               },
               scrollToField: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 97,
+                  lineNumber: 100,
                 },
                 type: '(path: string, locale?: string) => Promise<void>',
               },
               setFieldValue: {
                 comment: {
-                  comment: 'Changes a specific path of the `formValues` object',
+                  markdownText:
+                    'Changes a specific path of the `formValues` object.',
                   example:
                     "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 112,
+                  lineNumber: 115,
                 },
                 type: '(path: string, value: unknown) => Promise<void>',
               },
               formValuesToItem: {
                 comment: {
-                  comment:
+                  markdownText:
                     'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                   example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 129,
+                  lineNumber: 132,
                 },
                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
               },
               itemToFormValues: {
                 comment: {
-                  comment:
-                    'Takes an Item entity, and converts it into the internal form state',
+                  markdownText:
+                    'Takes an Item entity, and converts it into the internal form state.',
                   example: 'await ctx.itemToFormValues(ctx.item);',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 142,
+                  lineNumber: 145,
                 },
                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
               },
               saveCurrentItem: {
                 comment: {
-                  comment: 'Triggers a submit form for current record',
+                  markdownText: 'Triggers a submit form for current record.',
                   example: 'await ctx.saveCurrentItem();',
                 },
                 location: {
                   filePath: 'src/ctx/commonExtras/itemForm.ts',
-                  lineNumber: 154,
+                  lineNumber: 157,
                 },
                 type: '(showToast?: boolean) => Promise<void>',
               },
@@ -2699,8 +2822,8 @@ export const manifest: Manifest = {
     customMarksForStructuredTextField: {
       name: 'customMarksForStructuredTextField',
       comment: {
-        comment:
-          'Use this function to define a number of custom marks for a specific\nStructured Text field',
+        markdownText:
+          'Use this function to define a number of custom marks for a specific\nStructured Text field.',
         tag: 'structuredText',
       },
       nonCtxArguments: [
@@ -2735,8 +2858,8 @@ export const manifest: Manifest = {
     customBlockStylesForStructuredTextField: {
       name: 'customBlockStylesForStructuredTextField',
       comment: {
-        comment:
-          'Use this function to define a number of custom block styles for a specific\nStructured Text field',
+        markdownText:
+          'Use this function to define a number of custom block styles for a specific\nStructured Text field.',
         tag: 'structuredText',
       },
       nonCtxArguments: [
@@ -2772,8 +2895,8 @@ export const manifest: Manifest = {
     contentAreaSidebarItems: {
       name: 'contentAreaSidebarItems',
       comment: {
-        comment:
-          'Use this function to declare new items in the content area sidebar',
+        markdownText:
+          'Use this function to declare new items in the content area sidebar.',
         tag: 'sidebarItems',
       },
       nonCtxArguments: [],
@@ -2791,8 +2914,8 @@ export const manifest: Manifest = {
     buildItemPresentationInfo: {
       name: 'buildItemPresentationInfo',
       comment: {
-        comment:
-          'Use this function to customize the presentation of a record in records\ncollections and "Single link" or "Multiple links" field',
+        markdownText:
+          'Use this function to customize the presentation of a record in records\ncollections and "Single link" or "Multiple links" field.',
         tag: 'presentation',
       },
       nonCtxArguments: [
@@ -2815,8 +2938,8 @@ export const manifest: Manifest = {
     assetSources: {
       name: 'assetSources',
       comment: {
-        comment:
-          'Use this function to declare additional sources to be shown when users want\nto upload new assets',
+        markdownText:
+          'Use this function to declare additional sources to be shown when users want\nto upload new assets.',
         tag: 'assetSources',
       },
       nonCtxArguments: [],
@@ -2837,13 +2960,13 @@ export const manifest: Manifest = {
       {
         name: 'PluginProperties',
         comment: {
-          comment:
+          markdownText:
             "Information about the current plugin. Useful to access the plugin's global\nconfiguration object.",
         },
         items: {
           plugin: {
             comment: {
-              comment: 'The current plugin',
+              markdownText: 'The current plugin.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2856,12 +2979,12 @@ export const manifest: Manifest = {
       {
         name: 'AuthenticationProperties',
         comment: {
-          comment: 'Information about the current user using the CMS',
+          markdownText: 'Information about the current user using the CMS.',
         },
         items: {
           currentUser: {
             comment: {
-              comment:
+              markdownText:
                 'The current DatoCMS user. It can either be the owner or one of the\ncollaborators (regular or SSO).',
             },
             location: {
@@ -2872,7 +2995,7 @@ export const manifest: Manifest = {
           },
           currentRole: {
             comment: {
-              comment: 'The role for the current DatoCMS user',
+              markdownText: 'The role for the current DatoCMS user.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2882,8 +3005,8 @@ export const manifest: Manifest = {
           },
           currentUserAccessToken: {
             comment: {
-              comment:
-                'The access token to perform API calls on behalf of the current user. Only\navailable if `currentUserAccessToken` additional permission is granted',
+              markdownText:
+                'The access token to perform API calls on behalf of the current user. Only\navailable if `currentUserAccessToken` additional permission is granted.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2898,7 +3021,7 @@ export const manifest: Manifest = {
         items: {
           site: {
             comment: {
-              comment: 'The current DatoCMS project',
+              markdownText: 'The current DatoCMS project.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2908,7 +3031,7 @@ export const manifest: Manifest = {
           },
           environment: {
             comment: {
-              comment: 'The ID of the current environment',
+              markdownText: 'The ID of the current environment.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2918,7 +3041,8 @@ export const manifest: Manifest = {
           },
           owner: {
             comment: {
-              comment: 'The account that is the project owner',
+              markdownText:
+                'The account/organization that is the project owner.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2928,7 +3052,9 @@ export const manifest: Manifest = {
           },
           account: {
             comment: {
-              comment: 'The account that is the project owner',
+              markdownText: 'The account that is the project owner.',
+              deprecatedMarkdownText:
+                'Please use `.owner` instead, as the project owner can also be\nan organization',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2938,8 +3064,8 @@ export const manifest: Manifest = {
           },
           ui: {
             comment: {
-              comment:
-                'UI preferences of the current user (right now, only the preferred locale is\navailable)',
+              markdownText:
+                'UI preferences of the current user (right now, only the preferred locale is\navailable).',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2949,8 +3075,8 @@ export const manifest: Manifest = {
           },
           theme: {
             comment: {
-              comment:
-                'An object containing the theme colors for the current DatoCMS project',
+              markdownText:
+                'An object containing the theme colors for the current DatoCMS project.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2963,14 +3089,14 @@ export const manifest: Manifest = {
       {
         name: 'EntityReposProperties',
         comment: {
-          comment:
+          markdownText:
             'These properties provide access to "entity repos", that is, the collection of\nresources of a particular type that have been loaded by the CMS up to this\nmoment. The entity repos are objects, indexed by the ID of the entity itself.',
         },
         items: {
           itemTypes: {
             comment: {
-              comment:
-                'All the models of the current DatoCMS project, indexed by ID',
+              markdownText:
+                'All the models of the current DatoCMS project, indexed by ID.',
             },
             location: {
               filePath: 'src/ctx/base.ts',
@@ -2980,7 +3106,7 @@ export const manifest: Manifest = {
           },
           fields: {
             comment: {
-              comment:
+              markdownText:
                 'All the fields currently loaded for the current DatoCMS project, indexed by\nID. If some fields you need are not present, use the `loadItemTypeFields`\nfunction to load them.',
             },
             location: {
@@ -2991,7 +3117,7 @@ export const manifest: Manifest = {
           },
           fieldsets: {
             comment: {
-              comment:
+              markdownText:
                 'All the fieldsets currently loaded for the current DatoCMS project, indexed\nby ID. If some fields you need are not present, use the\n`loadItemTypeFieldsets` function to load them.',
             },
             location: {
@@ -3002,7 +3128,7 @@ export const manifest: Manifest = {
           },
           users: {
             comment: {
-              comment:
+              markdownText:
                 'All the regular users currently loaded for the current DatoCMS project,\nindexed by ID. It will always contain the current user. If some users you\nneed are not present, use the `loadUsers` function to load them.',
             },
             location: {
@@ -3013,7 +3139,7 @@ export const manifest: Manifest = {
           },
           ssoUsers: {
             comment: {
-              comment:
+              markdownText:
                 'All the SSO users currently loaded for the current DatoCMS project, indexed\nby ID. It will always contain the current user. If some users you need are\nnot present, use the `loadSsoUsers` function to load them.',
             },
             location: {
@@ -3029,13 +3155,13 @@ export const manifest: Manifest = {
       {
         name: 'LoadDataMethods',
         comment: {
-          comment:
-            'These methods can be used to asyncronously load additional information your\nplugin needs to work',
+          markdownText:
+            'These methods can be used to asyncronously load additional information your\nplugin needs to work.',
         },
         items: {
           loadItemTypeFields: {
             comment: {
-              comment:
+              markdownText:
                 'Loads all the fields for a specific model (or block). Fields will be\nreturned and will also be available in the the `fields` property.',
               example:
                 "const itemTypeId = prompt('Please insert a model ID:');\n\nconst fields = await ctx.loadItemTypeFields(itemTypeId);\n\nctx.notice(\n  `Success! ${fields\n    .map((field) => field.attributes.api_key)\n    .join(', ')}`,\n);",
@@ -3048,7 +3174,7 @@ export const manifest: Manifest = {
           },
           loadItemTypeFieldsets: {
             comment: {
-              comment:
+              markdownText:
                 'Loads all the fieldsets for a specific model (or block). Fieldsets will be\nreturned and will also be available in the the `fieldsets` property.',
               example:
                 "const itemTypeId = prompt('Please insert a model ID:');\n\nconst fieldsets = await ctx.loadItemTypeFieldsets(itemTypeId);\n\nctx.notice(\n  `Success! ${fieldsets\n    .map((fieldset) => fieldset.attributes.title)\n    .join(', ')}`,\n);",
@@ -3061,7 +3187,7 @@ export const manifest: Manifest = {
           },
           loadFieldsUsingPlugin: {
             comment: {
-              comment:
+              markdownText:
                 'Loads all the fields in the project that are currently using the plugin for\none of its manual field extensions.',
               example:
                 "const fields = await ctx.loadFieldsUsingPlugin();\n\nctx.notice(\n  `Success! ${fields\n    .map((field) => field.attributes.api_key)\n    .join(', ')}`,\n);",
@@ -3074,7 +3200,7 @@ export const manifest: Manifest = {
           },
           loadUsers: {
             comment: {
-              comment:
+              markdownText:
                 'Loads all regular users. Users will be returned and will also be available\nin the the `users` property.',
               example:
                 "const users = await ctx.loadUsers();\n\nctx.notice(`Success! ${users.map((user) => user.id).join(', ')}`);",
@@ -3087,7 +3213,7 @@ export const manifest: Manifest = {
           },
           loadSsoUsers: {
             comment: {
-              comment:
+              markdownText:
                 'Loads all SSO users. Users will be returned and will also be available in\nthe the `ssoUsers` property.',
               example:
                 "const users = await ctx.loadSsoUsers();\n\nctx.notice(`Success! ${users.map((user) => user.id).join(', ')}`);",
@@ -3103,13 +3229,13 @@ export const manifest: Manifest = {
       {
         name: 'UpdatePluginParametersMethods',
         comment: {
-          comment:
+          markdownText:
             'These methods can be used to update both plugin parameters and manual field\nextensions configuration.',
         },
         items: {
           updatePluginParameters: {
             comment: {
-              comment:
+              markdownText:
                 'Updates the plugin parameters.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
               example:
                 "await ctx.updatePluginParameters({ debugMode: true });\nawait ctx.notice('Plugin parameters successfully updated!');",
@@ -3122,7 +3248,7 @@ export const manifest: Manifest = {
           },
           updateFieldAppearance: {
             comment: {
-              comment:
+              markdownText:
                 'Performs changes in the appearance of a field. You can install/remove a\nmanual field extension, or tweak their parameters. If multiple changes are\npassed, they will be applied sequencially.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
               example:
                 "const fields = await ctx.loadFieldsUsingPlugin();\n\nif (fields.length === 0) {\n  ctx.alert('No field is using this plugin as a manual extension!');\n  return;\n}\n\nfor (const field of fields) {\n  const { appearance } = field.attributes;\n  const operations = [];\n\n  if (appearance.editor === ctx.plugin.id) {\n    operations.push({\n      operation: 'updateEditor',\n      newParameters: {\n        ...appearance.parameters,\n        foo: 'bar',\n      },\n    });\n  }\n\n  appearance.addons.forEach((addon, i) => {\n    if (addon.id !== ctx.plugin.id) {\n      return;\n    }\n\n    operations.push({\n      operation: 'updateAddon',\n      index: i,\n      newParameters: { ...addon.parameters, foo: 'bar' },\n    });\n  });\n\n  await ctx.updateFieldAppearance(field.id, operations);\n  ctx.notice(`Successfully edited field ${field.attributes.api_key}`);\n}",
@@ -3138,14 +3264,14 @@ export const manifest: Manifest = {
       {
         name: 'ToastMethods',
         comment: {
-          comment:
-            'These methods can be used to show UI-consistent toast notifications to the\nend-user',
+          markdownText:
+            'These methods can be used to show UI-consistent toast notifications to the\nend-user.',
         },
         items: {
           alert: {
             comment: {
-              comment:
-                'Triggers an "error" toast displaying the selected message',
+              markdownText:
+                'Triggers an "error" toast displaying the selected message.',
               example:
                 "const message = prompt(\n  'Please insert a message:',\n  'This is an alert message!',\n);\n\nawait ctx.alert(message);",
             },
@@ -3157,8 +3283,8 @@ export const manifest: Manifest = {
           },
           notice: {
             comment: {
-              comment:
-                'Triggers a "success" toast displaying the selected message',
+              markdownText:
+                'Triggers a "success" toast displaying the selected message.',
               example:
                 "const message = prompt(\n  'Please insert a message:',\n  'This is a notice message!',\n);\n\nawait ctx.notice(message);",
             },
@@ -3170,8 +3296,8 @@ export const manifest: Manifest = {
           },
           customToast: {
             comment: {
-              comment:
-                'Triggers a custom toast displaying the selected message (and optionally a\nCTA)',
+              markdownText:
+                'Triggers a custom toast displaying the selected message (and optionally a\nCTA).',
               example:
                 "const result = await ctx.customToast({\n  type: 'warning',\n  message: 'Just a sample warning notification!',\n  dismissOnPageChange: true,\n  dismissAfterTimeout: 5000,\n  cta: {\n    label: 'Execute call-to-action',\n    value: 'cta',\n  },\n});\n\nif (result === 'cta') {\n  ctx.notice(`Clicked CTA!`);\n}",
             },
@@ -3186,13 +3312,13 @@ export const manifest: Manifest = {
       {
         name: 'ItemDialogMethods',
         comment: {
-          comment:
-            'These methods let you open the standard DatoCMS dialogs needed to interact\nwith records',
+          markdownText:
+            'These methods let you open the standard DatoCMS dialogs needed to interact\nwith records.',
         },
         items: {
           createNewItem: {
             comment: {
-              comment:
+              markdownText:
                 'Opens a dialog for creating a new record. It returns a promise resolved\nwith the newly created record or `null` if the user closes the dialog\nwithout creating anything.',
               example:
                 "const itemTypeId = prompt('Please insert a model ID:');\n\nconst item = await ctx.createNewItem(itemTypeId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
@@ -3205,7 +3331,7 @@ export const manifest: Manifest = {
           },
           selectItem: {
             comment: {
-              comment:
+              markdownText:
                 'Opens a dialog for selecting one (or multiple) record(s) from a list of\nexisting records of type `itemTypeId`. It returns a promise resolved with\nthe selected record(s), or `null` if the user closes the dialog without\nchoosing any record.',
               example:
                 "const itemTypeId = prompt('Please insert a model ID:');\n\nconst items = await ctx.selectItem(itemTypeId, { multiple: true });\n\nif (items) {\n  ctx.notice(`Success! ${items.map((i) => i.id).join(', ')}`);\n} else {\n  ctx.alert('Closed!');\n}",
@@ -3218,7 +3344,7 @@ export const manifest: Manifest = {
           },
           editItem: {
             comment: {
-              comment:
+              markdownText:
                 'Opens a dialog for editing an existing record. It returns a promise\nresolved with the edited record, or `null` if the user closes the dialog\nwithout persisting any change.',
               example:
                 "const itemId = prompt('Please insert a record ID:');\n\nconst item = await ctx.editItem(itemId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
@@ -3234,13 +3360,13 @@ export const manifest: Manifest = {
       {
         name: 'UploadDialogMethods',
         comment: {
-          comment:
-            'These methods let you open the standard DatoCMS dialogs needed to interact\nwith Media Area assets',
+          markdownText:
+            'These methods let you open the standard DatoCMS dialogs needed to interact\nwith Media Area assets.',
         },
         items: {
           selectUpload: {
             comment: {
-              comment:
+              markdownText:
                 'Opens a dialog for selecting one (or multiple) existing asset(s). It\nreturns a promise resolved with the selected asset(s), or `null` if the\nuser closes the dialog without selecting any upload.',
               example:
                 "const item = await ctx.selectUpload({ multiple: false });\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
@@ -3253,8 +3379,8 @@ export const manifest: Manifest = {
           },
           editUpload: {
             comment: {
-              comment:
-                'Opens a dialog for editing a Media Area asset. It returns a promise\nresolved with:\n\n- The updated asset, if the user persists some changes to the asset itself\n- `null`, if the user closes the dialog without persisting any change\n- An asset structure with an additional `deleted` property set to true, if\n  the user deletes the asset',
+              markdownText:
+                'Opens a dialog for editing a Media Area asset. It returns a promise\nresolved with:\n\n- The updated asset, if the user persists some changes to the asset itself\n- `null`, if the user closes the dialog without persisting any change\n- An asset structure with an additional `deleted` property set to true, if\n  the user deletes the asset.',
               example:
                 "const uploadId = prompt('Please insert an asset ID:');\n\nconst item = await ctx.editUpload(uploadId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
             },
@@ -3266,7 +3392,7 @@ export const manifest: Manifest = {
           },
           editUploadMetadata: {
             comment: {
-              comment:
+              markdownText:
                 'Opens a dialog for editing a "single asset" field structure. It returns a\npromise resolved with the updated structure, or `null` if the user closes\nthe dialog without persisting any change.',
               example:
                 "const uploadId = prompt('Please insert an asset ID:');\n\nconst result = await ctx.editUploadMetadata({\n  upload_id: uploadId,\n  alt: null,\n  title: null,\n  custom_data: {},\n  focal_point: null,\n});\n\nif (result) {\n  ctx.notice(`Success! ${JSON.stringify(result)}`);\n} else {\n  ctx.alert('Closed!');\n}",
@@ -3282,14 +3408,14 @@ export const manifest: Manifest = {
       {
         name: 'CustomDialogMethods',
         comment: {
-          comment:
-            'These methods can be used to open custom dialogs/confirmation panels',
+          markdownText:
+            'These methods can be used to open custom dialogs/confirmation panels.',
         },
         items: {
           openModal: {
             comment: {
-              comment:
-                'Opens a custom modal. Returns a promise resolved with what the modal itself\nreturns calling the `resolve()` function',
+              markdownText:
+                'Opens a custom modal. Returns a promise resolved with what the modal itself\nreturns calling the `resolve()` function.',
               example:
                 "const result = await ctx.openModal({\n  id: 'regular',\n  title: 'Custom title!',\n  width: 'l',\n  parameters: { foo: 'bar' },\n});\n\nif (result) {\n  ctx.notice(`Success! ${JSON.stringify(result)}`);\n} else {\n  ctx.alert('Closed!');\n}",
             },
@@ -3301,8 +3427,8 @@ export const manifest: Manifest = {
           },
           openConfirm: {
             comment: {
-              comment:
-                'Opens a UI-consistent confirmation dialog. Returns a promise resolved with\nthe value of the choice made by the user',
+              markdownText:
+                'Opens a UI-consistent confirmation dialog. Returns a promise resolved with\nthe value of the choice made by the user.',
               example:
                 "const result = await ctx.openConfirm({\n  title: 'Custom title',\n  content:\n    'Lorem Ipsum is simply dummy text of the printing and typesetting industry',\n  choices: [\n    {\n      label: 'Positive',\n      value: 'positive',\n      intent: 'positive',\n    },\n    {\n      label: 'Negative',\n      value: 'negative',\n      intent: 'negative',\n    },\n  ],\n  cancel: {\n    label: 'Cancel',\n    value: false,\n  },\n});\n\nif (result) {\n  ctx.notice(`Success! ${result}`);\n} else {\n  ctx.alert('Cancelled!');\n}",
             },
@@ -3317,13 +3443,14 @@ export const manifest: Manifest = {
       {
         name: 'NavigateMethods',
         comment: {
-          comment:
-            'These methods can be used to take the user to different pages',
+          markdownText:
+            'These methods can be used to take the user to different pages.',
         },
         items: {
           navigateTo: {
             comment: {
-              comment: 'Moves the user to another URL internal to the backend',
+              markdownText:
+                'Moves the user to another URL internal to the backend.',
               example: "await ctx.navigateTo('/');",
             },
             location: {
@@ -3337,36 +3464,41 @@ export const manifest: Manifest = {
     ],
   },
   selfResizingPluginFrameCtxSizingUtilities: {
+    name: 'SizingUtilities',
+    comment: {
+      markdownText:
+        'A number of methods that you can use to control the size of the plugin frame.',
+    },
     items: {
       startAutoResizer: {
         comment: {
-          comment:
+          markdownText:
             "Listens for DOM changes and automatically calls `setHeight` when it detects\na change. If you're using `datocms-react-ui` package, the `<Canvas />`\ncomponent already takes care of calling this method for you.",
         },
         location: {
           filePath: 'src/ctx/commonExtras/sizing.ts',
-          lineNumber: 7,
+          lineNumber: 8,
         },
         type: '() => void',
       },
       stopAutoResizer: {
         comment: {
-          comment: 'Stops resizing the iframe automatically',
+          markdownText: 'Stops resizing the iframe automatically.',
         },
         location: {
           filePath: 'src/ctx/commonExtras/sizing.ts',
-          lineNumber: 10,
+          lineNumber: 11,
         },
         type: '() => void',
       },
       updateHeight: {
         comment: {
-          comment:
-            "Triggers a change in the size of the iframe. If you don't explicitely pass\na `newHeight` it will be automatically calculated using the iframe content\nat the moment",
+          markdownText:
+            "Triggers a change in the size of the iframe. If you don't explicitely pass\na `newHeight` it will be automatically calculated using the iframe content\nat the moment.",
         },
         location: {
           filePath: 'src/ctx/commonExtras/sizing.ts',
-          lineNumber: 17,
+          lineNumber: 18,
         },
         type: '(newHeight?: number) => void',
       },