title: Automatically generating api annotations used for APIDOC
body: <p>I am creating API documentation and have decided to use APIDOC (<a href="https://apidocjs.com/" rel="nofollow noreferrer">https://apidocjs.com/</a>) for generating my documentation. I am wondering if there exists a tool that can generate the inline documentation annotations automatically from my python api file.</p>
  <p>This is the result i would like generated for me:</p>
  <pre><code>&quot;&quot;&quot;
  @api {get} /user/:id Request User information
  @apiName GetUser
  @apiGroup User
  
  @apiParam {Number} id Users unique ID.
  
  @apiSuccess {String} firstname Firstname of the User.
  @apiSuccess {String} lastname  Lastname of the User.
  &quot;&quot;&quot;
  </code></pre>