datocms-plugin-sdk 2.0.2 → 2.0.4

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: [
@@ -423,12 +423,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -438,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',
@@ -448,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',
@@ -458,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',
@@ -468,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',
@@ -478,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',
@@ -488,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',
@@ -498,7 +498,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -512,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',
@@ -522,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',
@@ -537,12 +537,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -553,7 +553,7 @@ exports.manifest = {
                             },
                             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: {
@@ -564,7 +564,7 @@ exports.manifest = {
                             },
                             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: {
@@ -575,7 +575,7 @@ exports.manifest = {
                             },
                             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: {
@@ -586,7 +586,7 @@ exports.manifest = {
                             },
                             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: {
@@ -597,7 +597,7 @@ exports.manifest = {
                             },
                             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: {
@@ -608,7 +608,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -630,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: [
@@ -645,12 +645,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -660,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',
@@ -670,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',
@@ -680,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',
@@ -690,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',
@@ -700,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',
@@ -710,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',
@@ -720,7 +720,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -734,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',
@@ -744,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',
@@ -759,12 +759,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -775,7 +775,7 @@ exports.manifest = {
                             },
                             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: {
@@ -786,7 +786,7 @@ exports.manifest = {
                             },
                             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: {
@@ -797,7 +797,7 @@ exports.manifest = {
                             },
                             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: {
@@ -808,7 +808,7 @@ exports.manifest = {
                             },
                             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: {
@@ -819,7 +819,7 @@ exports.manifest = {
                             },
                             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: {
@@ -830,7 +830,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -852,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: [
@@ -867,12 +867,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -882,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',
@@ -892,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',
@@ -902,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',
@@ -912,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',
@@ -922,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',
@@ -932,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',
@@ -942,7 +942,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -956,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',
@@ -971,12 +971,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -987,7 +987,7 @@ exports.manifest = {
                             },
                             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: {
@@ -998,7 +998,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1009,7 +1009,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1020,7 +1020,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1031,7 +1031,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1042,7 +1042,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -1064,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 `itemCollectionOutlets()` hook.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -1080,14 +1080,24 @@ 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',
-                                    lineNumber: 21,
+                                    lineNumber: 24,
                                 },
                                 type: 'string',
                             },
+                            itemType: {
+                                comment: {
+                                    markdownText: 'The model for which the outlet is being rendered.',
+                                },
+                                location: {
+                                    filePath: 'src/hooks/renderItemCollectionOutlet.ts',
+                                    lineNumber: 26,
+                                },
+                                type: 'ItemType',
+                            },
                         },
                     },
                 ],
@@ -1096,13 +1106,13 @@ exports.manifest = {
             returnType: 'void',
             location: {
                 filePath: 'src/hooks/renderItemCollectionOutlet.ts',
-                lineNumber: 11,
+                lineNumber: 14,
             },
         },
         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: [
@@ -1117,12 +1127,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -1132,7 +1142,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',
@@ -1142,7 +1152,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',
@@ -1152,7 +1162,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1162,7 +1172,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',
@@ -1172,7 +1182,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',
@@ -1182,7 +1192,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',
@@ -1192,7 +1202,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1205,12 +1215,12 @@ exports.manifest = {
                     {
                         name: 'FieldAdditionalProperties',
                         comment: {
-                            comment: 'These information describe the current state of the field where this plugin\nis applied to.',
+                            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',
@@ -1220,7 +1230,7 @@ exports.manifest = {
                             },
                             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',
@@ -1230,7 +1240,7 @@ exports.manifest = {
                             },
                             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',
@@ -1240,7 +1250,7 @@ exports.manifest = {
                             },
                             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',
@@ -1250,7 +1260,7 @@ exports.manifest = {
                             },
                             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',
@@ -1264,7 +1274,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',
@@ -1274,7 +1284,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',
@@ -1289,12 +1299,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -1305,7 +1315,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1316,7 +1326,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1327,7 +1337,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1338,7 +1348,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1349,7 +1359,7 @@ exports.manifest = {
                             },
                             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: {
@@ -1360,7 +1370,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -1382,7 +1392,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: [],
@@ -1400,7 +1410,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: [
@@ -1416,7 +1426,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',
@@ -1432,7 +1442,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: {
@@ -1454,7 +1464,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: [
@@ -1489,7 +1499,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: [],
@@ -1507,7 +1517,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: [
@@ -1530,7 +1540,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: [
@@ -1553,7 +1563,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: [
@@ -1576,7 +1586,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: [
@@ -1599,7 +1609,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: [],
@@ -1617,7 +1627,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: [],
@@ -1635,7 +1645,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: [
@@ -1670,7 +1680,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: [
@@ -1693,7 +1703,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: [
@@ -1716,7 +1726,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: [
@@ -1739,7 +1749,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: [
@@ -1754,12 +1764,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -1769,7 +1779,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',
@@ -1779,7 +1789,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',
@@ -1789,7 +1799,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1799,7 +1809,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',
@@ -1809,7 +1819,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',
@@ -1819,7 +1829,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',
@@ -1829,7 +1839,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1851,7 +1861,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: [
@@ -1874,7 +1884,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: [
@@ -1901,7 +1911,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: [
@@ -1916,12 +1926,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -1931,7 +1941,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',
@@ -1941,7 +1951,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',
@@ -1951,7 +1961,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1961,7 +1971,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',
@@ -1971,7 +1981,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',
@@ -1981,7 +1991,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',
@@ -1991,7 +2001,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2004,12 +2014,12 @@ exports.manifest = {
                     {
                         name: 'FieldAdditionalProperties',
                         comment: {
-                            comment: 'These information describe the current state of the field where this plugin\nis applied to.',
+                            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',
@@ -2019,7 +2029,7 @@ exports.manifest = {
                             },
                             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',
@@ -2029,7 +2039,7 @@ exports.manifest = {
                             },
                             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',
@@ -2039,7 +2049,7 @@ exports.manifest = {
                             },
                             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',
@@ -2049,7 +2059,7 @@ exports.manifest = {
                             },
                             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',
@@ -2071,7 +2081,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: [
@@ -2110,7 +2120,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: [
@@ -2149,7 +2159,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: [
@@ -2164,12 +2174,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -2179,7 +2189,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',
@@ -2189,7 +2199,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',
@@ -2199,7 +2209,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2209,7 +2219,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',
@@ -2219,7 +2229,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',
@@ -2229,7 +2239,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',
@@ -2239,7 +2249,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2265,12 +2275,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -2281,7 +2291,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2292,7 +2302,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2303,7 +2313,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2314,7 +2324,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2325,7 +2335,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2336,7 +2346,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -2358,7 +2368,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: [
@@ -2373,12 +2383,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalProperties',
                         comment: {
-                            comment: "These information describe the current state of the form that's being shown\nto the end-user to edit a record",
+                            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',
@@ -2388,7 +2398,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',
@@ -2398,7 +2408,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',
@@ -2408,7 +2418,7 @@ exports.manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2418,7 +2428,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',
@@ -2428,7 +2438,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',
@@ -2438,7 +2448,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',
@@ -2448,7 +2458,7 @@ exports.manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Provides information on how many blocks are currently present in the form',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2461,12 +2471,12 @@ exports.manifest = {
                     {
                         name: 'FieldAdditionalProperties',
                         comment: {
-                            comment: 'These information describe the current state of the field where this plugin\nis applied to.',
+                            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',
@@ -2476,7 +2486,7 @@ exports.manifest = {
                             },
                             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',
@@ -2486,7 +2496,7 @@ exports.manifest = {
                             },
                             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',
@@ -2496,7 +2506,7 @@ exports.manifest = {
                             },
                             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',
@@ -2506,7 +2516,7 @@ exports.manifest = {
                             },
                             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',
@@ -2532,12 +2542,12 @@ exports.manifest = {
                     {
                         name: 'ItemFormAdditionalMethods',
                         comment: {
-                            comment: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record",
+                            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: {
@@ -2548,7 +2558,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2559,7 +2569,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2570,7 +2580,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2581,7 +2591,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2592,7 +2602,7 @@ exports.manifest = {
                             },
                             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: {
@@ -2603,7 +2613,7 @@ exports.manifest = {
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
@@ -2625,7 +2635,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: [
@@ -2660,7 +2670,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: [
@@ -2695,7 +2705,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: [],
@@ -2713,7 +2723,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: [
@@ -2736,7 +2746,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: [],
@@ -2757,12 +2767,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',
@@ -2775,12 +2785,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',
@@ -2790,7 +2800,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',
@@ -2800,7 +2810,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',
@@ -2815,7 +2825,7 @@ exports.manifest = {
                 items: {
                     site: {
                         comment: {
-                            comment: 'The current DatoCMS project',
+                            markdownText: 'The current DatoCMS project.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2825,7 +2835,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',
@@ -2835,7 +2845,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',
@@ -2845,7 +2855,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',
@@ -2855,7 +2866,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',
@@ -2865,7 +2876,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',
@@ -2878,12 +2889,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',
@@ -2893,7 +2904,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',
@@ -2903,7 +2914,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',
@@ -2913,7 +2924,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',
@@ -2923,7 +2934,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',
@@ -2938,12 +2949,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: {
@@ -2954,7 +2965,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: {
@@ -2965,7 +2976,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: {
@@ -2976,7 +2987,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: {
@@ -2987,7 +2998,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: {
@@ -3001,12 +3012,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: {
@@ -3017,7 +3028,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: {
@@ -3031,12 +3042,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: {
@@ -3047,7 +3058,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: {
@@ -3058,7 +3069,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: {
@@ -3072,12 +3083,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: {
@@ -3088,7 +3099,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: {
@@ -3099,7 +3110,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: {
@@ -3113,12 +3124,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: {
@@ -3129,7 +3140,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: {
@@ -3140,7 +3151,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: {
@@ -3154,12 +3165,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: {
@@ -3170,7 +3181,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: {
@@ -3184,12 +3195,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: {
@@ -3205,12 +3216,12 @@ exports.manifest = {
     selfResizingPluginFrameCtxSizingUtilities: {
         name: 'SizingUtilities',
         comment: {
-            comment: 'A number of methods that you can use to control the size of the plugin frame',
+            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',
@@ -3220,7 +3231,7 @@ exports.manifest = {
             },
             stopAutoResizer: {
                 comment: {
-                    comment: 'Stops resizing the iframe automatically',
+                    markdownText: 'Stops resizing the iframe automatically.',
                 },
                 location: {
                     filePath: 'src/ctx/commonExtras/sizing.ts',
@@ -3230,7 +3241,7 @@ exports.manifest = {
             },
             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',