chore(*): replace inheritDoc with summary comment

Author: dobromirts

projects/igniteui-angular/src/lib/combo/combo-add-item.component.ts

@@ -16,9 +16,6 @@ export class IgxComboAddItemComponent extends IgxComboItemComponent {
     public set selected(value: boolean) {
     }
 
-    /**
-     * @inheritDoc
-     */
     public clicked(event?) {// eslint-disable-line
         this.comboAPI.disableTransitions = false;
         this.comboAPI.add_custom_item();

projects/igniteui-angular/src/lib/combo/combo-item.component.ts

@@ -95,9 +95,6 @@ export class IgxComboItemComponent extends IgxDropDownItemComponent {
         return rect.y >= parentDiv.y;
     }
 
-    /**
-     * @inheritDoc
-     */
     public clicked(event): void {
         this.comboAPI.disableTransitions = false;
         if (!this.isSelectable) {

projects/igniteui-angular/src/lib/drop-down/drop-down-item.component.ts

@@ -14,7 +14,11 @@ import { IgxDropDownItemBaseDirective } from './drop-down-item.base';
 })
 export class IgxDropDownItemComponent extends IgxDropDownItemBaseDirective {
     /**
-     * @inheritDoc
+     * Sets/gets if the given item is focused
+     * ```typescript
+     *  let mySelectedItem = this.dropdown.selectedItem;
+     *  let isMyItemFocused = mySelectedItem.focused;
+     * ```
      */
     public get focused(): boolean {
         let focusedState = this._focused;
@@ -27,15 +31,29 @@ export class IgxDropDownItemComponent extends IgxDropDownItemBaseDirective {
     }
 
     /**
-     * @inheritDoc
+     * Sets/gets if the given item is focused
+     * ```typescript
+     *  let mySelectedItem = this.dropdown.selectedItem;
+     *  let isMyItemFocused = mySelectedItem.focused;
+     * ```
      */
-     public set focused(value: boolean) {
+    public set focused(value: boolean) {
         this._focused = value;
     }
     /**
-     * @inheritDoc
+     * Sets/Gets if the item is the currently selected one in the dropdown
+     *
+     * ```typescript
+     *  let mySelectedItem = this.dropdown.selectedItem;
+     *  let isMyItemSelected = mySelectedItem.selected; // true
+     * ```
+     *
+     * Two-way data binding
+     * ```html
+     * <igx-drop-down-item [(selected)]='model.isSelected'></igx-drop-down-item>
+     * ```
      */
-     public get selected(): boolean {
+    public get selected(): boolean {
         if (this.hasIndex) {
             const item = this.selection.first_item(`${this.dropDown.id}`);
             return item ? item.index === this._index && item.value === this.value : false;
@@ -44,9 +62,10 @@ export class IgxDropDownItemComponent extends IgxDropDownItemBaseDirective {
     }
 
     /**
-     * @inheritDoc
+     * Sets/Gets if the item is the currently selected one in the dropdown
+     *
      */
-     public set selected(value: boolean) {
+    public set selected(value: boolean) {
         if (this.isHeader) {
             return;
         }
@@ -66,10 +85,7 @@ export class IgxDropDownItemComponent extends IgxDropDownItemBaseDirective {
         }
     }
 
-    /**
-     * @inheritDoc
-     */
-     public clicked(event): void {
+    public clicked(event): void {
         if (!this.isSelectable) {
             this.ensureItemFocus();
             return;

projects/igniteui-angular/src/lib/grids/grid/grid.component.ts

@@ -1065,7 +1065,12 @@ export class IgxGridComponent extends IgxGridBaseDirective implements GridType,
     }
 
     /**
-     * @inheritDoc
+     *
+     * Returns an array of the current cell selection in the form of `[{ column.field: cell.value }, ...]`.
+     *
+     * @remarks
+     * If `formatters` is enabled, the cell value will be formatted by its respective column formatter (if any).
+     * If `headers` is enabled, it will use the column header (if any) instead of the column field.
      */
     public getSelectedData(formatters = false, headers = false): any[] {
         if (this.groupingExpressions.length || this.hasDetails) {

projects/igniteui-angular/src/lib/grids/tree-grid/tree-grid.component.ts

@@ -673,7 +673,12 @@ export class IgxTreeGridComponent extends IgxGridBaseDirective implements GridTy
     }
 
     /**
-     * @inheritDoc
+     *
+     * Returns an array of the current cell selection in the form of `[{ column.field: cell.value }, ...]`.
+     *
+     * @remarks
+     * If `formatters` is enabled, the cell value will be formatted by its respective column formatter (if any).
+     * If `headers` is enabled, it will use the column header (if any) instead of the column field.
      */
     public getSelectedData(formatters = false, headers = false): any[] {
         let source = [];

projects/igniteui-angular/src/lib/select/select-positioning-strategy.ts

@@ -8,7 +8,9 @@ import { Optional } from '@angular/core';
 
 /** @hidden @internal */
 export class SelectPositioningStrategy extends BaseFitPositionStrategy implements IPositionStrategy {
-    /** @inheritDoc */
+    /**
+     * PositionSettings to use when position the component in the overlay
+     */
     public settings: PositionSettings;
 
     private _selectDefaultSettings = {
@@ -30,7 +32,18 @@ export class SelectPositioningStrategy extends BaseFitPositionStrategy implement
         this.settings = Object.assign({}, this._selectDefaultSettings, settings);
     }
 
-    /** @inheritDoc */
+    /**
+     * Position the element based on the PositionStrategy implementing this interface.
+     *
+     * @param contentElement The HTML element to be positioned
+     * @param size Size of the element
+     * @param document reference to the Document object
+     * @param initialCall should be true if this is the initial call to the method
+     * @param target attaching target for the component to show
+     * ```typescript
+     * settings.positionStrategy.position(content, size, document, true);
+     * ```
+     */
     public position(contentElement: HTMLElement,
                     size: Size,
                     document?: Document,

projects/igniteui-angular/src/lib/services/overlay/position/auto-position-strategy.ts

@@ -9,7 +9,12 @@ import { BaseFitPositionStrategy } from './base-fit-position-strategy';
  */
 export class AutoPositionStrategy extends BaseFitPositionStrategy {
 
-    /** @inheritDoc */
+    /**
+     * Fits the element into viewport according to the position settings
+     *
+     * @param element element to fit in viewport
+     * @param connectedFit connectedFit object containing all necessary parameters
+     */
     protected fitInViewport(element: HTMLElement, connectedFit: ConnectedFit) {
         const transformString: string[] = [];
         if (connectedFit.fitHorizontal.back < 0 || connectedFit.fitHorizontal.forward < 0) {

projects/igniteui-angular/src/lib/services/overlay/position/base-fit-position-strategy.ts

@@ -5,7 +5,18 @@ export abstract class BaseFitPositionStrategy extends ConnectedPositioningStrate
     protected _initialSize: Size;
     protected _initialSettings: PositionSettings;
 
-    /** @inheritDoc */
+    /**
+     * Position the element based on the PositionStrategy implementing this interface.
+     *
+     * @param contentElement The HTML element to be positioned
+     * @param size Size of the element
+     * @param document reference to the Document object
+     * @param initialCall should be true if this is the initial call to the method
+     * @param target attaching target for the component to show
+     * ```typescript
+     * settings.positionStrategy.position(content, size, document, true);
+     * ```
+     */
     public position(
         contentElement: HTMLElement, size: Size, document?: Document, initialCall?: boolean, target?: Point | HTMLElement): void {
         const targetElement = target || this.settings.target;

projects/igniteui-angular/src/lib/services/overlay/position/connected-positioning-strategy.ts

@@ -15,7 +15,9 @@ import { IPositionStrategy } from './IPositionStrategy';
  * It is possible to either pass a start point or an HTMLElement as a positioning base.
  */
 export class ConnectedPositioningStrategy implements IPositionStrategy {
-  /** @inheritDoc */
+  /**
+   * PositionSettings to use when position the component in the overlay
+   */
   public settings: PositionSettings;
 
   private _defaultSettings: PositionSettings = {
@@ -32,15 +34,25 @@ export class ConnectedPositioningStrategy implements IPositionStrategy {
     this.settings = Object.assign({}, this._defaultSettings, settings);
   }
 
-  /** @inheritDoc */
+  /**
+   * Position the element based on the PositionStrategy implementing this interface.
+   *
+   * @param contentElement The HTML element to be positioned
+   * @param size Size of the element
+   * @param document reference to the Document object
+   * @param initialCall should be true if this is the initial call to the method
+   * @param target attaching target for the component to show
+   * ```typescript
+   * settings.positionStrategy.position(content, size, document, true);
+   * ```
+   */
   public position(contentElement: HTMLElement, size: Size, document?: Document, initialCall?: boolean, target?: Point | HTMLElement): void {
     const targetElement = target || this.settings.target;
-    const rects =  this.calculateElementRectangles(contentElement, targetElement);
+    const rects = this.calculateElementRectangles(contentElement, targetElement);
     this.setStyle(contentElement, rects.targetRect, rects.elementRect, {});
   }
 
   /**
-   * @inheritDoc
    * Creates clone of this position strategy
    * @returns clone of this position strategy
    */
@@ -53,12 +65,12 @@ export class ConnectedPositioningStrategy implements IPositionStrategy {
    *
    * @returns target and element DomRect objects
    */
-  protected calculateElementRectangles(contentElement, target: Point | HTMLElement):
-    { targetRect: Partial<DOMRect>; elementRect: Partial<DOMRect> } {
-      return {
-          targetRect: Util.getTargetRect(target),
-          elementRect: contentElement.getBoundingClientRect() as DOMRect
-      };
+   protected calculateElementRectangles(contentElement, target: Point | HTMLElement):
+   { targetRect: Partial<DOMRect>; elementRect: Partial<DOMRect> } {
+    return {
+      targetRect: Util.getTargetRect(target),
+      elementRect: contentElement.getBoundingClientRect() as DOMRect
+    };
   }
 
   /**
@@ -70,8 +82,8 @@ export class ConnectedPositioningStrategy implements IPositionStrategy {
    * @param elementRect Bounding rectangle of the element
    */
   protected setStyle(element: HTMLElement, targetRect: Partial<DOMRect>, elementRect: Partial<DOMRect>, connectedFit: ConnectedFit) {
-      const horizontalOffset = connectedFit.horizontalOffset ? connectedFit.horizontalOffset : 0;
-      const verticalOffset = connectedFit.verticalOffset ? connectedFit.verticalOffset : 0;
+    const horizontalOffset = connectedFit.horizontalOffset ? connectedFit.horizontalOffset : 0;
+    const verticalOffset = connectedFit.verticalOffset ? connectedFit.verticalOffset : 0;
     const startPoint: Point = {
       x: targetRect.right + targetRect.width * this.settings.horizontalStartPoint + horizontalOffset,
       y: targetRect.bottom + targetRect.height * this.settings.verticalStartPoint + verticalOffset

projects/igniteui-angular/src/lib/services/overlay/position/container-position-strategy.ts

@@ -10,7 +10,9 @@ export class ContainerPositionStrategy extends GlobalPositionStrategy {
         super(settings);
     }
 
-    /** @inheritDoc */
+    /**
+     * Position the element based on the PositionStrategy implementing this interface.
+     */
     public position(contentElement: HTMLElement): void {
         contentElement.classList.add('igx-overlay__content--relative');
         contentElement.parentElement.classList.add('igx-overlay__wrapper--flex-container');