Improve API docs

https://constructs.dev/packages/aws-data-landing-zone is using the JSON output it seems. 

> that's right. API.md is coming from jsii-docgen not projen. jsii-docgen can also produce JSON as output and that's what construct hub uses.