title: How to document Node typescript AWS serverless API?
body: <p>My team is working on a new API using the <a href="https://www.serverless.com/" rel="nofollow noreferrer">Serverless</a> aws-nodejs-typescript template.</p>
  <p>In previous APIs we've used the <a href="https://github.com/deliveryhero/serverless-aws-documentation" rel="nofollow noreferrer">aws</a> or <a href="https://www.serverless.com/plugins/serverless-openapi-documentation" rel="nofollow noreferrer">openAPI</a> plugin for Serverless in order to document our APIs. However, we find it cumbersome since it requires an extra effort after development and implementation. Also it might become outdated whenever the team drops the bar regarding keeping it up to date.</p>
  <p>We would like to use some kind of annotations similar to springdoc-openapi-ui for Java. I've seen there exists a <a href="https://www.npmjs.com/package/typescript-rest-swagger" rel="nofollow noreferrer">Typescript Swagger package</a>, however it seems to be right choice when not using Serverless(AWS) but for instance <a href="https://developer.mozilla.org/en-US/docs/Learn/Server-side/Express_Nodejs/Introduction" rel="nofollow noreferrer">Express</a>.</p>
  <p>Has anyone used or found the right tooling to document Serverless AWS lambda APIs using Node and Typescript?</p>
  <p>Any suggestion or hint will be more than welcomed!</p>
  <p>Thanks!</p>