diff --git a/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/dialog-api/dialog-api.component.html b/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/dialog-api/dialog-api.component.html
index 7edda6af8..908255e90 100644
--- a/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/dialog-api/dialog-api.component.html
+++ b/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/dialog-api/dialog-api.component.html
@@ -1,5 +1,15 @@
-<dxc-heading [level]="3" weight="normal" text="API" [margin]="{bottom:'small'}"></dxc-heading>
+<dxc-heading
+  [level]="3"
+  weight="normal"
+  text="API"
+  [margin]="{ bottom: 'small' }"
+></dxc-heading>
 
 <dialog-table-properties></dialog-table-properties>
 
-<dialog-import></dialog-import>
\ No newline at end of file
+<p>
+  This component uses the pattern content projection, so all content inside will
+  be accepted and rendered inside the dialog.
+</p>
+
+<dialog-import></dialog-import>
diff --git a/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/properties/dialog-table-properties.component.html b/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/properties/dialog-table-properties.component.html
index 6e9eefd2a..a6530f471 100644
--- a/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/properties/dialog-table-properties.component.html
+++ b/projects/dxc-ngx-cdk-site/src/app/components/examples/dialog/properties/dialog-table-properties.component.html
@@ -21,16 +21,16 @@
     <td>onCloseClick: EventEmitter</td>
     <td></td>
     <td>
-      This function will be called when the user clicks the close 'x' button.
-      The user has the responsibility of hidding the modal.
+      This event will emit when the user clicks the close 'x' button. The
+      responsibility of hiding the dialog lies with the user.
     </td>
   </tr>
   <tr>
     <td>onBackgroundClick: EventEmitter</td>
     <td></td>
     <td>
-      This function will be called when the user clicks background of the modal
-      button. The user has the responsibility of hidding the modal.
+      This event will emit when the user clicks the background. The
+      responsibility of hiding the dialog lies with the user.
     </td>
   </tr>
   <tr>
@@ -38,10 +38,13 @@
     <td>
       <code>true</code>
     </td>
-    <td>If true, the dialog will be displayed over a darker background.</td>
+    <td>
+      If true, the dialog will be displayed over a darker background that covers
+      the content behind
+    </td>
   </tr>
   <tr>
-    <td>padding: any (string | object)</td>
+    <td>padding: string | object</td>
     <td></td>
     <td>
       Size of the padding to be applied to the component ('xxsmall' | 'xsmall' |
@@ -53,6 +56,6 @@
   <tr>
     <td>tabIndexValue: number</td>
     <td><code>0</code></td>
-    <td>Value of the tabindex given to the close 'x' button.</td>
+    <td>Value of the tabindex given to the close button.</td>
   </tr>
 </dxc-table>
diff --git a/projects/dxc-ngx-cdk/src/lib/dxc-dialog/dxc-dialog.component.ts b/projects/dxc-ngx-cdk/src/lib/dxc-dialog/dxc-dialog.component.ts
index 1a652b8cf..2ab7251bd 100644
--- a/projects/dxc-ngx-cdk/src/lib/dxc-dialog/dxc-dialog.component.ts
+++ b/projects/dxc-ngx-cdk/src/lib/dxc-dialog/dxc-dialog.component.ts
@@ -15,12 +15,32 @@ import {
 } from "@angular/cdk/coercion";
 import { BackgroundProviderService } from "../background-provider/service/background-provider.service";
 
+type Space = {
+  xxsmall: "6px";
+  xsmall: "16px";
+  small: "24px";
+  medium: "36px";
+  large: "48px";
+  xlarge: "64px";
+  xxlarge: "100px";
+};
+
+type Padding = {
+  top?: Space;
+  bottom?: Space;
+  left?: Space;
+  right?: Space;
+};
+
 @Component({
   selector: "dxc-dialog",
   templateUrl: "./dxc-dialog.component.html",
   providers: [CssUtils, BackgroundProviderService],
 })
 export class DxcDialogComponent {
+  /**
+   * If true, the dialog will be displayed over a darker background that covers the content behind.
+   */
   @Input()
   get overlay(): boolean {
     return this._overlay;
@@ -29,6 +49,10 @@ export class DxcDialogComponent {
     this._overlay = coerceBooleanProperty(value);
   }
   private _overlay;
+
+  /**
+   * If true, the close 'x' button will be visible.
+   */
   @Input()
   get isCloseVisible(): boolean {
     return this._isCloseVisible;
@@ -37,7 +61,18 @@ export class DxcDialogComponent {
     this._isCloseVisible = coerceBooleanProperty(value);
   }
   private _isCloseVisible = true;
-  @Input() padding: any;
+
+  /**
+   * Size of the padding to be applied to the component ('xxsmall' | 'xsmall' |
+   * 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge'). You can pass an
+   * object with 'top', 'bottom', 'left' and 'right' to
+   * specify different padding sizes.
+   */
+  @Input() padding: Space | Padding;
+
+  /**
+   * Value of the tabindex given to the close button.
+   */
   @Input()
   get tabIndexValue(): number {
     return this._tabIndexValue;
@@ -46,8 +81,18 @@ export class DxcDialogComponent {
     this._tabIndexValue = coerceNumberProperty(value);
   }
   private _tabIndexValue;
-  @Output() onCloseClick = new EventEmitter<any>();
-  @Output() onBackgroundClick = new EventEmitter<any>();
+
+  /**
+   * This event will emit when the user clicks the close 'x' button.
+   * The responsibility of hiding the dialog lies with the user.
+   */
+  @Output() onCloseClick: EventEmitter<void> = new EventEmitter<void>();
+
+  /**
+   * This event will emit when the user clicks the background.
+   * The responsibility of hiding the dialog lies with the user. 
+   * */
+  @Output() onBackgroundClick: EventEmitter<void> = new EventEmitter<void>();
 
   @HostBinding("class") className;
 
@@ -79,11 +124,11 @@ export class DxcDialogComponent {
   }
 
   public onCloseHandler($event: any): void {
-    this.onCloseClick.emit($event);
+    this.onCloseClick.emit();
   }
 
   public onBackgroundClickHandler($event: any): void {
-    this.onBackgroundClick.emit($event);
+    this.onBackgroundClick.emit();
   }
 
   private overlayStyle(overlay: boolean) {
@@ -172,7 +217,7 @@ export class DxcDialogComponent {
                 width: 3px;
               }
               ::-webkit-scrollbar-track {
-                background-color: #D9D9D9;
+                background-color: #d9d9d9;
                 border-radius: 3px;
               }
               ::-webkit-scrollbar-thumb {