Question

如何使用go-swagger 生成Api文档

Answer 1

看来你还没理解maven，maven的设计思想之一是”约定优于配置“，最大优势在于”依赖管理“。archetype这个插件里面就是内置了一些app,web-app的类型，maven把他认为的最佳实践都内置好了，你所做的是按照约定把该放的东西放到位置，当然你也可以像你说的把一些代码改地方，你可以仔细研究一下archetype插件的文档中一些参数，不过maven官方不推荐改动，因为大家都遵循差不多的规定，然后在pom.xml里面很简单的就配置好依赖关系，工程的扩展就容易了。maven希望是你把你的工程源代码按照maven建好的目录进行组织即可，如果这些不适合，你可以再看看其他插件里有没有合适的。你要是那样用，还不如用ant，怎么设置工程是活的，maven并不是取代ant，只是它用了另一套哲学。不知道你认同否

Answer 2

Web API文档工具列表 Swagger ——Swagger框架可以通过代码生成漂亮的在线API，甚至可以提供运行示例。支持Scala、Java、Javascript、Ruby、PHP甚至 Actionscript 3。在线 Demo 。 I/O Docs ——I/O Docs是一个用于RESTful Web APIs的交互式文档系统...