cajund (OP) [06/22/2023 - 15:33 ET]
Actually, not really. I want all of the elements of my infrastructure to be managed in the same place, in the same repo. We have compliance reasons for this, but there are many other good reasons to use consistent procedures and pipelines. My intentions with Stoplight are to create the YAML file using something more user friendly that a 10K+ line long swagger file. Tools like yours are helpful to maintain consistency and compliance, which is virtually impossible to do with a giant text file.
So, the swagger file that comes out of this tool goes into Terraform, and Terraform deploys the changes to the API gateway. I can track these changes in a repo as well as the historical logs for the pipeline run. I can also use the same swagger file to build local SAM-based environments for local development.
Making changes directly to the aws resource would be convenient (especially since the AWS Console experience is quite cumbersome), but at some point, those changes need to pass through automation to a production environment. Developers wouldn't be able to touch that directly. In fact, in many cases, they just have access to the code and not the AWS Console.
At this time, the copy/paste of the extension is practically a non-issue. Aside from this comment, it's working well.