[office-js][office-js-preview] (Dialog) Add a link to conceptual article (DefinitelyTyped#73610)

Author: samantharamon

types/office-js-preview/index.d.ts

@@ -611,19 +611,28 @@ declare namespace Office {
          */
         BindingSelectionChanged,
         /**
-         * Triggers when Dialog has an event, such as dialog closed or dialog navigation failed.
+         * Occurs when a dialog is closed or when dialog navigation failed.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogEventReceived,
         /**
-         * Triggers when a dialog sends a message via `messageParent`.
+         * Occurs when a dialog sends a message using `Office.context.ui.messageParent`.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogMessageReceived,
         /**
-         * Triggers when a host page sends a message to a child dialog box with `messageChild`.
+         * Occurs when a host page sends a message to a child dialog box with `Dialog.messageChild`.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogParentMessageReceived,
         /**
-         * Triggers when a document-level selection happens in Excel or Word.
+         * Occurs when a document-level selection happens in Excel or Word.
          */
         DocumentSelectionChanged,
         /**
@@ -699,15 +708,15 @@ declare namespace Office {
          */
         DragAndDropEvent,
         /**
-         * Triggers when a `customXmlPart` node is deleted.
+         * Occurs when a `customXmlPart` node is deleted.
          */
         NodeDeleted,
         /**
-         * Triggers when a `customXmlPart` node is inserted.
+         * Occurs when a `customXmlPart` node is inserted.
          */
         NodeInserted,
         /**
-         * Triggers when a `customXmlPart` node is replaced.
+         * Occurs when a `customXmlPart` node is replaced.
          */
         NodeReplaced,
         /**
@@ -752,7 +761,7 @@ declare namespace Office {
          */
         RecurrenceChanged,
         /**
-         * Triggers when a Resource selection happens in Project.
+         * Occurs when a Resource selection happens in Project.
          */
         ResourceSelectionChanged,
         /**
@@ -789,11 +798,11 @@ declare namespace Office {
          */
         SpamReporting,
         /**
-         * Triggers when a Task selection happens in Project.
+         * Occurs when a Task selection happens in Project.
          */
         TaskSelectionChanged,
         /**
-         * Triggers when a View selection happens in Project.
+         * Occurs when a View selection happens in Project.
          */
         ViewSelectionChanged
     }

types/office-js/index.d.ts

@@ -611,19 +611,28 @@ declare namespace Office {
          */
         BindingSelectionChanged,
         /**
-         * Triggers when Dialog has an event, such as dialog closed or dialog navigation failed.
+         * Occurs when a dialog is closed or when dialog navigation failed.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogEventReceived,
         /**
-         * Triggers when a dialog sends a message via `messageParent`.
+         * Occurs when a dialog sends a message using `Office.context.ui.messageParent`.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogMessageReceived,
         /**
-         * Triggers when a host page sends a message to a child dialog box with `messageChild`.
+         * Occurs when a host page sends a message to a child dialog box with `Dialog.messageChild`.
+         *
+         * For guidance on how to implement a dialog in your add-in, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/develop/dialog-api-in-office-add-ins | Use the Office dialog API in Office Add-ins}.
          */
         DialogParentMessageReceived,
         /**
-         * Triggers when a document-level selection happens in Excel or Word.
+         * Occurs when a document-level selection happens in Excel or Word.
          */
         DocumentSelectionChanged,
         /**
@@ -699,15 +708,15 @@ declare namespace Office {
          */
         DragAndDropEvent,
         /**
-         * Triggers when a `customXmlPart` node is deleted.
+         * Occurs when a `customXmlPart` node is deleted.
          */
         NodeDeleted,
         /**
-         * Triggers when a `customXmlPart` node is inserted.
+         * Occurs when a `customXmlPart` node is inserted.
          */
         NodeInserted,
         /**
-         * Triggers when a `customXmlPart` node is replaced.
+         * Occurs when a `customXmlPart` node is replaced.
          */
         NodeReplaced,
         /**
@@ -752,7 +761,7 @@ declare namespace Office {
          */
         RecurrenceChanged,
         /**
-         * Triggers when a Resource selection happens in Project.
+         * Occurs when a Resource selection happens in Project.
          */
         ResourceSelectionChanged,
         /**
@@ -789,11 +798,11 @@ declare namespace Office {
          */
         SpamReporting,
         /**
-         * Triggers when a Task selection happens in Project.
+         * Occurs when a Task selection happens in Project.
          */
         TaskSelectionChanged,
         /**
-         * Triggers when a View selection happens in Project.
+         * Occurs when a View selection happens in Project.
          */
         ViewSelectionChanged
     }