准备尝试下 Stoplight ，在初步接触中发现几个问题：
OpenAPI 没有接口目录概念，只有按照 Tag 进行分组。对于复杂项目，原来可能会有二级目录，现在就不太方便迁移。
编辑器左侧是 Paths(URL)聚合的， 而渲染出来是按照 Method+URL 分开。这个我理解是局限于 OpenAPI 的数据结构定义。但是这样对于编辑和渲染会产生一种不太一致的展示表现，不方便查找。
不知道大家有没有相同的困惑，是如何解决的呢？另外也有老项目很多接口设计不是那么 Restful 的缘故
这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.