title: How to document rest api using aws cdk
body: <p>I'm creating a REST API using AWS CDK version 1.22 and I would like to document my API using CDK as well, but I do not see any documentation generated for my API after deployment.</p>
  
  <p>I've dived into aws docs, cdk example, cdk reference but I could find concrete examples that help me understand how to do it.</p>
  
  <p>Here is my code:</p>
  
  <pre class="lang-js prettyprint-override"><code>const app = new App();
  const api = new APIStack(app, 'APIStack', { env }); // basic api gateway
  
  // API Resources
  const resourceProps: APIResourceProps = {
    gateway: api.gateway,
  }
  
  // dummy endpoint with some HTTP methods
  const siteResource = new APISiteStack(app, 'APISiteStack', {
    env,
    ...resourceProps
  });
  
  const siteResourceDocs = new APISiteDocs(app, 'APISiteDocs', {
    env,
    ...resourceProps,
  });
  
  // APISiteDocs is defined as follow:
  class APISiteDocs extends Stack {
  
    constructor(scope: Construct, id: string, props: APIResourceProps) {
      super(scope, id, props);
  
      new CfnDocumentationVersion(this, 'apiDocsVersion', {
        restApiId: props.gateway.restApiId,
        documentationVersion: config.app.name(`API-${config.gateway.api.version}`),
        description: 'Spare-It API Documentation',
      });
  
      new CfnDocumentationPart(this, 'siteDocs', {
        restApiId: props.gateway.restApiId,
        location: {
          type: 'RESOURCE',
          method: '*',
          path: APISiteStack.apiBasePath,
          statusCode: '405',
        },
        properties: `
          {
            "status": "error",
            "code": 405,
            "message": "Method Not Allowed"
          }
        `,
      });
    }
  }
  </code></pre>
  
  <p>Any help/hint is appreciated, Thanks.</p>