TINY-3535 Carrying over Lee's comments on the GH-1057 PR

ui-components/dialog.md

@@ -145,10 +145,10 @@ A **button** is a clickable component that can contain text or an icon. There ar
 | Name | Type | Requirement | Description |
 | ---- | ---- | ----------- | ----------- |
 | type | `'button'` | required | The component type. Must be `'button'`. |
-| text | string | required | Text to display in the button **if `icon` is not specified**. Also used for the button's `title` attribute. |
-| name | string | optional | A identifier for the button. If not specified, the button will be assigned a randomly generated `name`.  |
+| text | string | required | Text to display in the button if `icon` is not specified. Also used for the button's `title` attribute. |
+| name | string | optional | An identifier for the button. If not specified, the button will be assigned a randomly generated `name`.  |
 | icon | string | optional | Name of the icon to be displayed. Must correspond to an icon in the icon pack. **When configured, the button will display the icon instead of text.** |
-| primary | boolean | optional | Whether to style the button as a primary or secondary button. |
+| primary | boolean | optional | default: `false` - Whether to style the button as a primary or secondary button. |
 | disabled | boolean | optional | default: `false` - When `true`, the button will be disabled when the dialog loads. |
 | align | `'end'` or `'start'` | optional | default: `'end'` - When set to `'end'` the button will display on the right-hand side of the dialog. When set to `'start'` the button will display on the left-hand side. |
 
@@ -164,7 +164,7 @@ The different footer button types will invoke different callbacks when clicked:
 
 * A **Submit** type button will invoke the `onSubmit` callback function provided in the dialog configuration.
 * A **Cancel** type button will invoke the `onCancel` and `onClose` callback functions. These callback functions are also fired when a user clicks the `X` button in the top right of the dialog.
-* A **Custom** type button will invoke the `onAction` callback function, and pass it the button's `name` in the `details` object. This allows developers to create a click handler for each **Custom** type footer button in the dialog. See the [Redial example](#interactiveexampleusingredial) for an example of how to use this. A dialog can have multiple **Custom** type footer buttons.
+* A **Custom** type button will invoke the `onAction` callback function, and pass it the button's `name` in the `details` object. This allows developers to create a click handler for each **Custom** type footer button in the dialog. See the [Redial example](#interactiveexampleusingredial) for an example of how to use this.
 
 See the [dialog configuration options](#configurationoptions) documentation for more information.