Allow use of @apiUse in @apiSuccessExmample & @apiErrorExample

[IVoyt]

Feature request

Please add possibility to specify @APIuse as body of @apiSuccessEample and @apiErrorExample section to make api documenting more flexible

Why this is needed.

For example we have multiple endpoints with same response body but different response codes.
The following would allow to get rid of duplication

Currently we have write as follows

/**
 * @api {get} /some-route
 * @apiGroup Some Group
 * 
 * @apiSuccessExample {json} Response-Example:
 * HTTP/1.1 200 OK
 * {
 *     "data": {
 *       // data body
 *     }
 * }
 */

/**
 * @api {post} /some-route
 * @apiGroup Some Group
 * 
 * @apiSuccessExample {json} Response-Example:
 * HTTP/1.1 201 Created
 * {
 *     "data": {
 *       // data body
 *     }
 * }
 */

My proposal is to allow write as follows

/**
 * @api {get} /some-route
 * @apiGroup Some Group
 * 
 * @apiSuccessExample {json} Response-Example:
 * HTTP/1.1 200 OK
 * @apiUse responseExample
 */

/**
 * @api {get} /some-route
 * @apiGroup Some Group
 * 
 * @apiSuccessExample {json} Response-Example:
 * HTTP/1.1 201 Created
 * @apiUse responseExample
 */

/**
 * @apiDefine responseExample
 *
 * {
 *     "data": {
 *       // data body
 *     }
 * }
 *

[NicolasCARPi]

Hello,

Please take into account that there is nobody available to maintain this library. See #1436.