我想知道人们是否对如何从头开始编写文档和设计API有任何建议。目前，我正在考虑使用SwaggerUI创建Open API规范或使用Postman提供的文档功能。我认为毫无疑问，Postman几乎更易于使用，但是我很想听听其他人对最佳实践的看法。谢谢！
免责声明：我的意见在这里。
在我的个人项目中，我用招摇。
[在工作中，他们使用api文档（可能是出于遗留原因），他们的代码库为10年api docs website。
我建议使用编程语言而不是使用基于工具的文档的任何方法。