datocms-plugin-sdk 2.0.1 → 2.0.3

package/dist/cjs/manifest.js

@@ -6,7 +6,7 @@ exports.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 @@ exports.manifest = {
         uploadsDropdownActions: {
             name: 'uploadsDropdownActions',
             comment: {
-                comment: '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.',
+                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',
             },
             nonCtxArguments: [],
@@ -46,7 +46,7 @@ exports.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: [],
@@ -64,7 +64,7 @@ exports.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: [],
@@ -82,7 +82,7 @@ exports.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: [],
@@ -100,7 +100,7 @@ exports.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: [
@@ -116,7 +116,7 @@ exports.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',
@@ -126,7 +126,7 @@ exports.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',
@@ -136,7 +136,7 @@ exports.manifest = {
                             },
                             upload: {
                                 comment: {
-                                    comment: 'The active asset',
+                                    markdownText: 'The active asset.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -158,7 +158,7 @@ exports.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: [
@@ -174,7 +174,7 @@ exports.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',
@@ -184,7 +184,7 @@ exports.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',
@@ -194,7 +194,7 @@ exports.manifest = {
                             },
                             upload: {
                                 comment: {
-                                    comment: 'The active asset',
+                                    markdownText: 'The active asset.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -216,7 +216,7 @@ exports.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: [
@@ -232,7 +232,7 @@ exports.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',
@@ -254,7 +254,7 @@ exports.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: [
@@ -270,7 +270,7 @@ exports.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',
@@ -280,7 +280,7 @@ exports.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',
@@ -296,7 +296,7 @@ exports.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);",
                                 },
                                 location: {
@@ -330,7 +330,7 @@ exports.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: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -340,7 +340,7 @@ exports.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: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -350,7 +350,7 @@ exports.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: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -360,7 +360,7 @@ exports.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: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -370,7 +370,7 @@ exports.manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the field being edited',
+                                    markdownText: 'The model for the field being edited.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -386,7 +386,7 @@ exports.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: {
@@ -408,7 +408,7 @@ exports.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: [
@@ -421,10 +421,14 @@ exports.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',
@@ -434,7 +438,7 @@ exports.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',
@@ -444,7 +448,7 @@ exports.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',
@@ -454,7 +458,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -464,7 +468,7 @@ exports.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',
@@ -474,7 +478,7 @@ exports.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',
@@ -484,7 +488,7 @@ exports.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',
@@ -494,13 +498,13 @@ exports.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',
                             },
                         },
                     },
@@ -508,7 +512,7 @@ exports.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',
@@ -518,7 +522,7 @@ exports.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',
@@ -531,81 +535,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -622,7 +630,7 @@ exports.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: [
@@ -635,10 +643,14 @@ exports.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',
@@ -648,7 +660,7 @@ exports.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',
@@ -658,7 +670,7 @@ exports.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',
@@ -668,7 +680,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -678,7 +690,7 @@ exports.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',
@@ -688,7 +700,7 @@ exports.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',
@@ -698,7 +710,7 @@ exports.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',
@@ -708,13 +720,13 @@ exports.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',
                             },
                         },
                     },
@@ -722,7 +734,7 @@ exports.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',
@@ -732,7 +744,7 @@ exports.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',
@@ -745,81 +757,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -836,7 +852,7 @@ exports.manifest = {
         renderItemFormOutlet: {
             name: 'renderItemFormOutlet',
             comment: {
-                comment: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
+                markdownText: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -849,10 +865,14 @@ exports.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',
@@ -862,7 +882,7 @@ exports.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',
@@ -872,7 +892,7 @@ exports.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',
@@ -882,7 +902,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -892,7 +912,7 @@ exports.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',
@@ -902,7 +922,7 @@ exports.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',
@@ -912,7 +932,7 @@ exports.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',
@@ -922,13 +942,13 @@ exports.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',
                             },
                         },
                     },
@@ -936,7 +956,7 @@ exports.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',
@@ -949,81 +969,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -1040,7 +1064,7 @@ exports.manifest = {
         renderItemCollectionOutlet: {
             name: 'renderItemCollectionOutlet',
             comment: {
-                comment: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
+                markdownText: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -1056,7 +1080,7 @@ exports.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',
@@ -1078,7 +1102,7 @@ exports.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: [
@@ -1091,10 +1115,14 @@ exports.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',
@@ -1104,7 +1132,7 @@ exports.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',
@@ -1114,7 +1142,7 @@ exports.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',
@@ -1124,7 +1152,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1134,7 +1162,7 @@ exports.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',
@@ -1144,7 +1172,7 @@ exports.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',
@@ -1154,7 +1182,7 @@ exports.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',
@@ -1164,65 +1192,69 @@ exports.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: '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.',
+                                    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 }',
                             },
@@ -1232,7 +1264,7 @@ exports.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',
@@ -1242,7 +1274,7 @@ exports.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',
@@ -1255,81 +1287,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -1346,7 +1382,7 @@ exports.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: [],
@@ -1364,7 +1400,7 @@ exports.manifest = {
         renderAssetSource: {
             name: 'renderAssetSource',
             comment: {
-                comment: "This function will be called when the user selects one of the plugin's\nasset sources to upload a new media file.",
+                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',
             },
             nonCtxArguments: [
@@ -1380,7 +1416,7 @@ exports.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',
@@ -1396,7 +1432,7 @@ exports.manifest = {
                         items: {
                             select: {
                                 comment: {
-                                    comment: '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.',
+                                    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});",
                                 },
                                 location: {
@@ -1418,7 +1454,7 @@ exports.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: [
@@ -1453,7 +1489,7 @@ exports.manifest = {
         onBoot: {
             name: 'onBoot',
             comment: {
-                comment: 'This function will be called once at boot time and can be used to perform\nie. some initial integrity checks on the configuration.',
+                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',
             },
             nonCtxArguments: [],
@@ -1471,7 +1507,7 @@ exports.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: [
@@ -1494,7 +1530,7 @@ exports.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: [
@@ -1517,7 +1553,7 @@ exports.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: [
@@ -1540,7 +1576,7 @@ exports.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: [
@@ -1563,7 +1599,7 @@ exports.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: [],
@@ -1581,7 +1617,7 @@ exports.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: [],
@@ -1599,7 +1635,7 @@ exports.manifest = {
         itemsDropdownActions: {
             name: 'itemsDropdownActions',
             comment: {
-                comment: '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.',
+                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',
             },
             nonCtxArguments: [
@@ -1634,7 +1670,7 @@ exports.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: [
@@ -1657,7 +1693,7 @@ exports.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: [
@@ -1680,7 +1716,7 @@ exports.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: [
@@ -1703,7 +1739,7 @@ exports.manifest = {
         itemFormDropdownActions: {
             name: 'itemFormDropdownActions',
             comment: {
-                comment: '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.',
+                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',
             },
             nonCtxArguments: [
@@ -1716,10 +1752,14 @@ exports.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',
@@ -1729,7 +1769,7 @@ exports.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',
@@ -1739,7 +1779,7 @@ exports.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',
@@ -1749,7 +1789,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1759,7 +1799,7 @@ exports.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',
@@ -1769,7 +1809,7 @@ exports.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',
@@ -1779,7 +1819,7 @@ exports.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',
@@ -1789,13 +1829,13 @@ exports.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',
                             },
                         },
                     },
@@ -1811,7 +1851,7 @@ exports.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: [
@@ -1834,7 +1874,7 @@ exports.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: [
@@ -1861,7 +1901,7 @@ exports.manifest = {
         fieldDropdownActions: {
             name: 'fieldDropdownActions',
             comment: {
-                comment: '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.',
+                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',
             },
             nonCtxArguments: [
@@ -1874,10 +1914,14 @@ exports.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',
@@ -1887,7 +1931,7 @@ exports.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',
@@ -1897,7 +1941,7 @@ exports.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',
@@ -1907,7 +1951,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1917,7 +1961,7 @@ exports.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',
@@ -1927,7 +1971,7 @@ exports.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',
@@ -1937,7 +1981,7 @@ exports.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',
@@ -1947,65 +1991,69 @@ exports.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: '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.',
+                                    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 }',
                             },
@@ -2023,7 +2071,7 @@ exports.manifest = {
         executeUploadsDropdownAction: {
             name: 'executeUploadsDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `uploadsDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `uploadsDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2062,7 +2110,7 @@ exports.manifest = {
         executeItemsDropdownAction: {
             name: 'executeItemsDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `itemsDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `itemsDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2101,7 +2149,7 @@ exports.manifest = {
         executeItemFormDropdownAction: {
             name: 'executeItemFormDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `itemFormDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `itemFormDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2114,10 +2162,14 @@ exports.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',
@@ -2127,7 +2179,7 @@ exports.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',
@@ -2137,7 +2189,7 @@ exports.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',
@@ -2147,7 +2199,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2157,7 +2209,7 @@ exports.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',
@@ -2167,7 +2219,7 @@ exports.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',
@@ -2177,7 +2229,7 @@ exports.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',
@@ -2187,13 +2239,13 @@ exports.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',
                             },
                         },
                     },
@@ -2211,81 +2263,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -2302,7 +2358,7 @@ exports.manifest = {
         executeFieldDropdownAction: {
             name: 'executeFieldDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `fieldDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `fieldDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2315,10 +2371,14 @@ exports.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',
@@ -2328,7 +2388,7 @@ exports.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',
@@ -2338,7 +2398,7 @@ exports.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',
@@ -2348,7 +2408,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2358,7 +2418,7 @@ exports.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',
@@ -2368,7 +2428,7 @@ exports.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',
@@ -2378,7 +2438,7 @@ exports.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',
@@ -2388,65 +2448,69 @@ exports.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: '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.',
+                                    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 }',
                             },
@@ -2466,81 +2530,85 @@ exports.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: '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.',
+                                    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: '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.',
+                                    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: '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`.',
+                                    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>',
                             },
@@ -2557,7 +2625,7 @@ exports.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: [
@@ -2592,7 +2660,7 @@ exports.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: [
@@ -2627,7 +2695,7 @@ exports.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: [],
@@ -2645,7 +2713,7 @@ exports.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: [
@@ -2668,7 +2736,7 @@ exports.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: [],
@@ -2689,12 +2757,12 @@ exports.manifest = {
             {
                 name: 'PluginProperties',
                 comment: {
-                    comment: "Information about the current plugin. Useful to access the plugin's global\nconfiguration object.",
+                    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',
@@ -2707,12 +2775,12 @@ exports.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: 'The current DatoCMS user. It can either be the owner or one of the\ncollaborators (regular or SSO).',
+                            markdownText: 'The current DatoCMS user. It can either be the owner or one of the\ncollaborators (regular or SSO).',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2722,7 +2790,7 @@ exports.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',
@@ -2732,7 +2800,7 @@ exports.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',
@@ -2747,7 +2815,7 @@ exports.manifest = {
                 items: {
                     site: {
                         comment: {
-                            comment: 'The current DatoCMS project',
+                            markdownText: 'The current DatoCMS project.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2757,7 +2825,7 @@ exports.manifest = {
                     },
                     environment: {
                         comment: {
-                            comment: 'The ID of the current environment',
+                            markdownText: 'The ID of the current environment.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2767,7 +2835,7 @@ exports.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',
@@ -2777,7 +2845,8 @@ exports.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',
@@ -2787,7 +2856,7 @@ exports.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',
@@ -2797,7 +2866,7 @@ exports.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',
@@ -2810,12 +2879,12 @@ exports.manifest = {
             {
                 name: 'EntityReposProperties',
                 comment: {
-                    comment: '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.',
+                    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',
@@ -2825,7 +2894,7 @@ exports.manifest = {
                     },
                     fields: {
                         comment: {
-                            comment: '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.',
+                            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: {
                             filePath: 'src/ctx/base.ts',
@@ -2835,7 +2904,7 @@ exports.manifest = {
                     },
                     fieldsets: {
                         comment: {
-                            comment: '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.',
+                            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: {
                             filePath: 'src/ctx/base.ts',
@@ -2845,7 +2914,7 @@ exports.manifest = {
                     },
                     users: {
                         comment: {
-                            comment: '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.',
+                            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: {
                             filePath: 'src/ctx/base.ts',
@@ -2855,7 +2924,7 @@ exports.manifest = {
                     },
                     ssoUsers: {
                         comment: {
-                            comment: '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.',
+                            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: {
                             filePath: 'src/ctx/base.ts',
@@ -2870,12 +2939,12 @@ exports.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: 'Loads all the fields for a specific model (or block). Fields will be\nreturned and will also be available in the the `fields` property.',
+                            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);",
                         },
                         location: {
@@ -2886,7 +2955,7 @@ exports.manifest = {
                     },
                     loadItemTypeFieldsets: {
                         comment: {
-                            comment: 'Loads all the fieldsets for a specific model (or block). Fieldsets will be\nreturned and will also be available in the the `fieldsets` property.',
+                            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);",
                         },
                         location: {
@@ -2897,7 +2966,7 @@ exports.manifest = {
                     },
                     loadFieldsUsingPlugin: {
                         comment: {
-                            comment: 'Loads all the fields in the project that are currently using the plugin for\none of its manual field extensions.',
+                            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);",
                         },
                         location: {
@@ -2908,7 +2977,7 @@ exports.manifest = {
                     },
                     loadUsers: {
                         comment: {
-                            comment: 'Loads all regular users. Users will be returned and will also be available\nin the the `users` property.',
+                            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(', ')}`);",
                         },
                         location: {
@@ -2919,7 +2988,7 @@ exports.manifest = {
                     },
                     loadSsoUsers: {
                         comment: {
-                            comment: 'Loads all SSO users. Users will be returned and will also be available in\nthe the `ssoUsers` property.',
+                            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(', ')}`);",
                         },
                         location: {
@@ -2933,12 +3002,12 @@ exports.manifest = {
             {
                 name: 'UpdatePluginParametersMethods',
                 comment: {
-                    comment: 'These methods can be used to update both plugin parameters and manual field\nextensions configuration.',
+                    markdownText: 'These methods can be used to update both plugin parameters and manual field\nextensions configuration.',
                 },
                 items: {
                     updatePluginParameters: {
                         comment: {
-                            comment: '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.',
+                            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!');",
                         },
                         location: {
@@ -2949,7 +3018,7 @@ exports.manifest = {
                     },
                     updateFieldAppearance: {
                         comment: {
-                            comment: '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.',
+                            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}",
                         },
                         location: {
@@ -2963,12 +3032,12 @@ exports.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);",
                         },
                         location: {
@@ -2979,7 +3048,7 @@ exports.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);",
                         },
                         location: {
@@ -2990,7 +3059,7 @@ exports.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}",
                         },
                         location: {
@@ -3004,12 +3073,12 @@ exports.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: '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.',
+                            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}",
                         },
                         location: {
@@ -3020,7 +3089,7 @@ exports.manifest = {
                     },
                     selectItem: {
                         comment: {
-                            comment: '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.',
+                            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}",
                         },
                         location: {
@@ -3031,7 +3100,7 @@ exports.manifest = {
                     },
                     editItem: {
                         comment: {
-                            comment: '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.',
+                            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}",
                         },
                         location: {
@@ -3045,12 +3114,12 @@ exports.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: '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.',
+                            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}",
                         },
                         location: {
@@ -3061,7 +3130,7 @@ exports.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}",
                         },
                         location: {
@@ -3072,7 +3141,7 @@ exports.manifest = {
                     },
                     editUploadMetadata: {
                         comment: {
-                            comment: '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.',
+                            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}",
                         },
                         location: {
@@ -3086,12 +3155,12 @@ exports.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}",
                         },
                         location: {
@@ -3102,7 +3171,7 @@ exports.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}",
                         },
                         location: {
@@ -3116,12 +3185,12 @@ exports.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: {
@@ -3135,34 +3204,38 @@ exports.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: "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.",
+                    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',
             },