hettlage (133) [Avatar] Offline
#1
Thanks for the gentle introduction to the Open API Specification in Chapter 4!

I think the chapter would gain considerable value if you dedicated more space on the OAS ecosystem in general, and Swagger UI in particular. The Swagger editor is really impressive, but at the end of the day, you want to host your API documentation somewhere. This may be a crucial consideration when deciding whether to use OAS, and if you are a careless reader like me it is quite easy to miss the importance of Swagger UI in this respect. So including a section on showing how to get it running (and what it's doing) would be great.

Also, editing files in a text editor or IDE obviously has advantages over editing them a browser. As such advice on plugins for editing OAS v3 files in some editors and IDEs should be very welcome.