本文将列出主要的升级过程中的要点和使用 OAS 3 记录 API 的要点。其中一些要点可能仍适用于之前的 OAS 2（前称 Swagger）文档，但值得一提，因为我之前没有充分注意到它们。