从this question中我已经看到
Swagger和Slate有两个不同的用途。 Swagger是一种尝试以标准方式描述RESTful API的尝试。
另一方面，Slate是编写漂亮的API文档的漂亮主题。
它进一步指出
两者不是互斥的 理想情况下，应该从您的Swagger API描述生成您的Slate文档
我有点困惑。当我已经拥有Swagger UI like so时，为什么还要选择板岩。
“文档”还需要什么？我确实是在问，因为正如我说的那样，我对它们的用法有些困惑。
答案 0 :(得分：1)
为新API创建文档时，有几件事值得一提。
Swagger提供了一个非常不错的图形界面，用于探索API的端点，但是您的文档中还应该包含其他内容，包括（但不限于）：