datocms-plugin-sdk 2.0.2 → 2.0.3

package/manifest.json

@@ -3,7 +3,7 @@
     "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": [
@@ -25,7 +25,7 @@
     "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": [],
@@ -43,7 +43,7 @@
     "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": [],
@@ -61,7 +61,7 @@
     "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": [],
@@ -79,7 +79,7 @@
     "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": [],
@@ -97,7 +97,7 @@
     "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": [
@@ -113,7 +113,7 @@
             "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",
@@ -123,7 +123,7 @@
               },
               "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",
@@ -133,7 +133,7 @@
               },
               "upload": {
                 "comment": {
-                  "comment": "The active asset"
+                  "markdownText": "The active asset."
                 },
                 "location": {
                   "filePath": "src/hooks/renderUploadSidebarPanel.ts",
@@ -155,7 +155,7 @@
     "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": [
@@ -171,7 +171,7 @@
             "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",
@@ -181,7 +181,7 @@
               },
               "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",
@@ -191,7 +191,7 @@
               },
               "upload": {
                 "comment": {
-                  "comment": "The active asset"
+                  "markdownText": "The active asset."
                 },
                 "location": {
                   "filePath": "src/hooks/renderUploadSidebar.ts",
@@ -213,7 +213,7 @@
     "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": [
@@ -229,7 +229,7 @@
             "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",
@@ -251,7 +251,7 @@
     "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": [
@@ -267,7 +267,7 @@
             "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",
@@ -277,7 +277,7 @@
               },
               "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",
@@ -293,7 +293,7 @@
             "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": {
@@ -327,7 +327,7 @@
             "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",
@@ -337,7 +337,7 @@
               },
               "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",
@@ -347,7 +347,7 @@
               },
               "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",
@@ -357,7 +357,7 @@
               },
               "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",
@@ -367,7 +367,7 @@
               },
               "itemType": {
                 "comment": {
-                  "comment": "The model for the field being edited"
+                  "markdownText": "The model for the field being edited."
                 },
                 "location": {
                   "filePath": "src/hooks/renderManualFieldExtensionConfigScreen.ts",
@@ -383,7 +383,7 @@
             "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": {
@@ -405,7 +405,7 @@
     "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": [
@@ -420,12 +420,12 @@
           {
             "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",
@@ -435,7 +435,7 @@
               },
               "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",
@@ -445,7 +445,7 @@
               },
               "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",
@@ -455,7 +455,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -465,7 +465,7 @@
               },
               "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",
@@ -475,7 +475,7 @@
               },
               "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",
@@ -485,7 +485,7 @@
               },
               "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",
@@ -495,7 +495,7 @@
               },
               "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",
@@ -509,7 +509,7 @@
             "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",
@@ -519,7 +519,7 @@
               },
               "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",
@@ -534,12 +534,12 @@
           {
             "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": {
@@ -550,7 +550,7 @@
               },
               "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": {
@@ -561,7 +561,7 @@
               },
               "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": {
@@ -572,7 +572,7 @@
               },
               "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": {
@@ -583,7 +583,7 @@
               },
               "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": {
@@ -594,7 +594,7 @@
               },
               "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": {
@@ -605,7 +605,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -627,7 +627,7 @@
     "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": [
@@ -642,12 +642,12 @@
           {
             "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",
@@ -657,7 +657,7 @@
               },
               "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",
@@ -667,7 +667,7 @@
               },
               "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",
@@ -677,7 +677,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -687,7 +687,7 @@
               },
               "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",
@@ -697,7 +697,7 @@
               },
               "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",
@@ -707,7 +707,7 @@
               },
               "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",
@@ -717,7 +717,7 @@
               },
               "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",
@@ -731,7 +731,7 @@
             "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",
@@ -741,7 +741,7 @@
               },
               "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",
@@ -756,12 +756,12 @@
           {
             "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": {
@@ -772,7 +772,7 @@
               },
               "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": {
@@ -783,7 +783,7 @@
               },
               "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": {
@@ -794,7 +794,7 @@
               },
               "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": {
@@ -805,7 +805,7 @@
               },
               "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": {
@@ -816,7 +816,7 @@
               },
               "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": {
@@ -827,7 +827,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -849,7 +849,7 @@
     "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": [
@@ -864,12 +864,12 @@
           {
             "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",
@@ -879,7 +879,7 @@
               },
               "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",
@@ -889,7 +889,7 @@
               },
               "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",
@@ -899,7 +899,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -909,7 +909,7 @@
               },
               "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",
@@ -919,7 +919,7 @@
               },
               "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",
@@ -929,7 +929,7 @@
               },
               "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",
@@ -939,7 +939,7 @@
               },
               "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",
@@ -953,7 +953,7 @@
             "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",
@@ -968,12 +968,12 @@
           {
             "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": {
@@ -984,7 +984,7 @@
               },
               "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": {
@@ -995,7 +995,7 @@
               },
               "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": {
@@ -1006,7 +1006,7 @@
               },
               "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": {
@@ -1017,7 +1017,7 @@
               },
               "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": {
@@ -1028,7 +1028,7 @@
               },
               "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": {
@@ -1039,7 +1039,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -1061,7 +1061,7 @@
     "renderItemCollectionOutlet": {
       "name": "renderItemCollectionOutlet",
       "comment": {
-        "comment": "This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.",
+        "markdownText": "This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.",
         "tag": "outlets"
       },
       "nonCtxArguments": [
@@ -1077,7 +1077,7 @@
             "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",
@@ -1099,7 +1099,7 @@
     "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": [
@@ -1114,12 +1114,12 @@
           {
             "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",
@@ -1129,7 +1129,7 @@
               },
               "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",
@@ -1139,7 +1139,7 @@
               },
               "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",
@@ -1149,7 +1149,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -1159,7 +1159,7 @@
               },
               "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",
@@ -1169,7 +1169,7 @@
               },
               "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",
@@ -1179,7 +1179,7 @@
               },
               "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",
@@ -1189,7 +1189,7 @@
               },
               "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",
@@ -1202,12 +1202,12 @@
           {
             "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",
@@ -1217,7 +1217,7 @@
               },
               "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",
@@ -1227,7 +1227,7 @@
               },
               "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",
@@ -1237,7 +1237,7 @@
               },
               "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",
@@ -1247,7 +1247,7 @@
               },
               "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",
@@ -1261,7 +1261,7 @@
             "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",
@@ -1271,7 +1271,7 @@
               },
               "parameters": {
                 "comment": {
-                  "comment": "The arbitrary `parameters` of the field extension"
+                  "markdownText": "The arbitrary `parameters` of the field extension."
                 },
                 "location": {
                   "filePath": "src/hooks/renderFieldExtension.ts",
@@ -1286,12 +1286,12 @@
           {
             "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": {
@@ -1302,7 +1302,7 @@
               },
               "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": {
@@ -1313,7 +1313,7 @@
               },
               "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": {
@@ -1324,7 +1324,7 @@
               },
               "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": {
@@ -1335,7 +1335,7 @@
               },
               "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": {
@@ -1346,7 +1346,7 @@
               },
               "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": {
@@ -1357,7 +1357,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -1379,7 +1379,7 @@
     "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": [],
@@ -1397,7 +1397,7 @@
     "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": [
@@ -1413,7 +1413,7 @@
             "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",
@@ -1429,7 +1429,7 @@
             "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": {
@@ -1451,7 +1451,7 @@
     "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": [
@@ -1486,7 +1486,7 @@
     "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": [],
@@ -1504,7 +1504,7 @@
     "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": [
@@ -1527,7 +1527,7 @@
     "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": [
@@ -1550,7 +1550,7 @@
     "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": [
@@ -1573,7 +1573,7 @@
     "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": [
@@ -1596,7 +1596,7 @@
     "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": [],
@@ -1614,7 +1614,7 @@
     "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": [],
@@ -1632,7 +1632,7 @@
     "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": [
@@ -1667,7 +1667,7 @@
     "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": [
@@ -1690,7 +1690,7 @@
     "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": [
@@ -1713,7 +1713,7 @@
     "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": [
@@ -1736,7 +1736,7 @@
     "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": [
@@ -1751,12 +1751,12 @@
           {
             "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",
@@ -1766,7 +1766,7 @@
               },
               "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",
@@ -1776,7 +1776,7 @@
               },
               "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",
@@ -1786,7 +1786,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -1796,7 +1796,7 @@
               },
               "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",
@@ -1806,7 +1806,7 @@
               },
               "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",
@@ -1816,7 +1816,7 @@
               },
               "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",
@@ -1826,7 +1826,7 @@
               },
               "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",
@@ -1848,7 +1848,7 @@
     "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": [
@@ -1871,7 +1871,7 @@
     "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": [
@@ -1898,7 +1898,7 @@
     "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": [
@@ -1913,12 +1913,12 @@
           {
             "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",
@@ -1928,7 +1928,7 @@
               },
               "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",
@@ -1938,7 +1938,7 @@
               },
               "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",
@@ -1948,7 +1948,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -1958,7 +1958,7 @@
               },
               "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",
@@ -1968,7 +1968,7 @@
               },
               "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",
@@ -1978,7 +1978,7 @@
               },
               "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",
@@ -1988,7 +1988,7 @@
               },
               "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",
@@ -2001,12 +2001,12 @@
           {
             "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",
@@ -2016,7 +2016,7 @@
               },
               "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",
@@ -2026,7 +2026,7 @@
               },
               "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",
@@ -2036,7 +2036,7 @@
               },
               "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",
@@ -2046,7 +2046,7 @@
               },
               "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",
@@ -2068,7 +2068,7 @@
     "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": [
@@ -2107,7 +2107,7 @@
     "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": [
@@ -2146,7 +2146,7 @@
     "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": [
@@ -2161,12 +2161,12 @@
           {
             "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",
@@ -2176,7 +2176,7 @@
               },
               "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",
@@ -2186,7 +2186,7 @@
               },
               "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",
@@ -2196,7 +2196,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -2206,7 +2206,7 @@
               },
               "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",
@@ -2216,7 +2216,7 @@
               },
               "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",
@@ -2226,7 +2226,7 @@
               },
               "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",
@@ -2236,7 +2236,7 @@
               },
               "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",
@@ -2262,12 +2262,12 @@
           {
             "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": {
@@ -2278,7 +2278,7 @@
               },
               "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": {
@@ -2289,7 +2289,7 @@
               },
               "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": {
@@ -2300,7 +2300,7 @@
               },
               "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": {
@@ -2311,7 +2311,7 @@
               },
               "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": {
@@ -2322,7 +2322,7 @@
               },
               "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": {
@@ -2333,7 +2333,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -2355,7 +2355,7 @@
     "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": [
@@ -2370,12 +2370,12 @@
           {
             "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",
@@ -2385,7 +2385,7 @@
               },
               "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",
@@ -2395,7 +2395,7 @@
               },
               "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",
@@ -2405,7 +2405,7 @@
               },
               "formValues": {
                 "comment": {
-                  "comment": "The complete internal form state"
+                  "markdownText": "The complete internal form state."
                 },
                 "location": {
                   "filePath": "src/ctx/commonExtras/itemForm.ts",
@@ -2415,7 +2415,7 @@
               },
               "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",
@@ -2425,7 +2425,7 @@
               },
               "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",
@@ -2435,7 +2435,7 @@
               },
               "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",
@@ -2445,7 +2445,7 @@
               },
               "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",
@@ -2458,12 +2458,12 @@
           {
             "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",
@@ -2473,7 +2473,7 @@
               },
               "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",
@@ -2483,7 +2483,7 @@
               },
               "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",
@@ -2493,7 +2493,7 @@
               },
               "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",
@@ -2503,7 +2503,7 @@
               },
               "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",
@@ -2529,12 +2529,12 @@
           {
             "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": {
@@ -2545,7 +2545,7 @@
               },
               "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": {
@@ -2556,7 +2556,7 @@
               },
               "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": {
@@ -2567,7 +2567,7 @@
               },
               "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": {
@@ -2578,7 +2578,7 @@
               },
               "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": {
@@ -2589,7 +2589,7 @@
               },
               "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": {
@@ -2600,7 +2600,7 @@
               },
               "saveCurrentItem": {
                 "comment": {
-                  "comment": "Triggers a submit form for current record",
+                  "markdownText": "Triggers a submit form for current record.",
                   "example": "await ctx.saveCurrentItem();"
                 },
                 "location": {
@@ -2622,7 +2622,7 @@
     "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": [
@@ -2657,7 +2657,7 @@
     "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": [
@@ -2692,7 +2692,7 @@
     "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": [],
@@ -2710,7 +2710,7 @@
     "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": [
@@ -2733,7 +2733,7 @@
     "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": [],
@@ -2754,12 +2754,12 @@
       {
         "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",
@@ -2772,12 +2772,12 @@
       {
         "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",
@@ -2787,7 +2787,7 @@
           },
           "currentRole": {
             "comment": {
-              "comment": "The role for the current DatoCMS user"
+              "markdownText": "The role for the current DatoCMS user."
             },
             "location": {
               "filePath": "src/ctx/base.ts",
@@ -2797,7 +2797,7 @@
           },
           "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",
@@ -2812,7 +2812,7 @@
         "items": {
           "site": {
             "comment": {
-              "comment": "The current DatoCMS project"
+              "markdownText": "The current DatoCMS project."
             },
             "location": {
               "filePath": "src/ctx/base.ts",
@@ -2822,7 +2822,7 @@
           },
           "environment": {
             "comment": {
-              "comment": "The ID of the current environment"
+              "markdownText": "The ID of the current environment."
             },
             "location": {
               "filePath": "src/ctx/base.ts",
@@ -2832,7 +2832,7 @@
           },
           "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",
@@ -2842,7 +2842,8 @@
           },
           "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",
@@ -2852,7 +2853,7 @@
           },
           "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",
@@ -2862,7 +2863,7 @@
           },
           "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",
@@ -2875,12 +2876,12 @@
       {
         "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",
@@ -2890,7 +2891,7 @@
           },
           "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",
@@ -2900,7 +2901,7 @@
           },
           "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",
@@ -2910,7 +2911,7 @@
           },
           "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",
@@ -2920,7 +2921,7 @@
           },
           "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",
@@ -2935,12 +2936,12 @@
       {
         "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": {
@@ -2951,7 +2952,7 @@
           },
           "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": {
@@ -2962,7 +2963,7 @@
           },
           "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": {
@@ -2973,7 +2974,7 @@
           },
           "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": {
@@ -2984,7 +2985,7 @@
           },
           "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": {
@@ -2998,12 +2999,12 @@
       {
         "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": {
@@ -3014,7 +3015,7 @@
           },
           "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": {
@@ -3028,12 +3029,12 @@
       {
         "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": {
@@ -3044,7 +3045,7 @@
           },
           "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": {
@@ -3055,7 +3056,7 @@
           },
           "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": {
@@ -3069,12 +3070,12 @@
       {
         "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": {
@@ -3085,7 +3086,7 @@
           },
           "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": {
@@ -3096,7 +3097,7 @@
           },
           "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": {
@@ -3110,12 +3111,12 @@
       {
         "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": {
@@ -3126,7 +3127,7 @@
           },
           "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": {
@@ -3137,7 +3138,7 @@
           },
           "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": {
@@ -3151,12 +3152,12 @@
       {
         "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": {
@@ -3167,7 +3168,7 @@
           },
           "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": {
@@ -3181,12 +3182,12 @@
       {
         "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": {
@@ -3202,12 +3203,12 @@
   "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",
@@ -3217,7 +3218,7 @@
       },
       "stopAutoResizer": {
         "comment": {
-          "comment": "Stops resizing the iframe automatically"
+          "markdownText": "Stops resizing the iframe automatically."
         },
         "location": {
           "filePath": "src/ctx/commonExtras/sizing.ts",
@@ -3227,7 +3228,7 @@
       },
       "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",