Typescript Plugin with Angular - Cannot avoid using @desc inside method headers

[mgithubmessier]

Short summary of your issue

If @desc is not explicitly used, and a description is provided in the first portion of the comment on a method, then both @param and @returns, are not documented inside of the output.

Input data for reproducing

{
  "destination": "./doc",
  "includes": [
    "\\.ts"
  ],
  "excludes": [
    ".*node_modules.*"
  ],
  "lint": false,
  "plugins": [
    {
      "name": "esdoc-standard-plugin",
      "option": {
        "coverage": {
          "enable": true
        }
      }
    },
    {
        "name": "esdoc-typescript-plugin", 
        "option": {
            "enable": true
      }
    },
    {
      "name": "esdoc-plugin-require-coverage",
      "option": {
        "required": 0
      }
    }
  ]
}

Codes

/**
 * methodName - some description here
 * @param {object} param1 - description
 * @return {object} description 
 * @example example code here
 */
 methodName(param1: object): object {
     return {};
 }

Screen shot of documentation

Your environment

• OS type and version: OS X El Capitan 10.11.6
• Node.js version: 8.4.0
• ESDoc version: 1.01

[jan-molak]

Same with @example esdoc/esdoc#502