fix review comments

Author: cal-smith

src/dialog/dialog-placeholder.component.ts

@@ -7,6 +7,7 @@ import {
 import { PlaceholderService } from "./../placeholder/placeholder.module";
 
 /**
+ * Deprecated as of v2.0, will be removed with v3.0
  * Using a dialog (popover, tooltip, etc) with appendToBody="true" in your application
  * requires *this* component (`n-dialog-placeholder`).
  * It would generally be placed near the end of your app component template
@@ -25,9 +26,7 @@ import { PlaceholderService } from "./../placeholder/placeholder.module";
  * <ibm-dialog-placeholder></ibm-dialog-placeholder>
  * ```
  *
- * @export
- * @class DialogPlaceholderComponent
- * @implements {OnInit}
+ * @deprecated
  */
 @Component({
 	selector: "ibm-dialog-placeholder",

src/modal/base-modal.class.ts

@@ -1,9 +1,9 @@
 import { Output, EventEmitter } from "@angular/core";
 
 /**
- * Extend BaseModal in your custom modal implementations to ensure consistent close behaviour.
+ * Extend `BaseModal` in your custom modal implementations to ensure consistent close behaviour.
  *
- * ModalService depends on the `close` event to correctly clean up the component.
+ * `ModalService` depends on the `close` event to correctly clean up the component.
  */
 export class BaseModal {
 	@Output() close = new EventEmitter();

src/modal/modal-placeholder.component.ts

@@ -8,6 +8,7 @@ import { PlaceholderService } from "./../placeholder/placeholder.service";
 
 
 /**
+ * Deprecated with v2.0, will be removed in v3.0
  * Using a modal in your application requires *this* component (`n-modal-placeholder`).
  * It would generally be placed near the end of your app component template
  * (app.component.ts or app.component.html) as:
@@ -32,9 +33,7 @@ import { PlaceholderService } from "./../placeholder/placeholder.service";
  * <ibm-modal-placeholder></ibm-modal-placeholder>
  * ```
  *
- * @export
- * @class ModalPlaceholderComponent
- * @implements {OnInit}
+ * @deprecated
  */
 @Component({
 	selector: "ibm-modal-placeholder",

src/modal/modal.decorator.ts

@@ -1,14 +1,13 @@
 import { Output, EventEmitter } from "@angular/core";
 
 /**
- * # Deprecated - extend BaseModal instead
+ * # Deprecated - extend `BaseModal` instead
  *
  * Decorator used to apply metadata on `Modal` class.
  *
  * class: ModalContainer
  *
  * decorator: @Modal
- * @class ModalContainer
  * @deprecated
  */
 class ModalContainer {

src/placeholder/placeholder.component.ts

@@ -12,7 +12,7 @@ import { PlaceholderService } from "./placeholder.service";
  * It would generally be placed near the end of your root app component template
  * (app.component.ts or app.component.html) as:
  *
- * ...
+ * ```
  * <ibm-placeholder></ibm-placeholder>
  * ```
  *