npm install --save-dev apidoc apidoc-plugin-ts

@apiInterface (optional path) {INTERFACE_NAME}

filename: ./employers.ts

export interface Employer {
  /**
   * Employer job title
   */
  jobTitle: string;
  /**
   * Employer personal details
   */
  personalDetails: {
    name: string;
    age: number;
  }
}

 @apiInterface (./employers.ts) {Person}

 @apiSuccess {String} jobTitle Job title
 @apiSuccess {Object} personalDetails Empoyer personal details
 @apiSuccess {String} personalDetails.name
 @apiSuccess {Number} personalDetails.age 

 @apiInterface {Person}