Comment by joeemison

It's the difference between having great documentation and full sample applications and just having a skeletal description of bare API calls. The review of API Gateway does a pretty nice job of laying out how the latter can be a pretty awful DX.