我有一个使用RestDocs生成端点文档的Java / Maven项目。
对于不熟悉RestDocs的人,它的工作是在构建过程中监视测试,并使用测试中的信息生成“代码段”,这些代码段在mvn软件包阶段用于使用asciidoc创建API文档。
我面临的问题是,如果asciidoc(.adoc)文件引用了不存在的代码段,则会生成该文档,并会显示类似以下内容:
“ myDoc.adoc中的未解决指令-包括:: {snippets} /error-example/response-fields.adoc []”
由于这种情况是在测试后发生的,所以我不知道如何测试类似内容,以便构建可以停止并让开发人员知道他们需要更新.adoc或代码段。
任何指导将不胜感激。
答案 0 :(得分:0)
将其添加到asciidoctor插件的配置时,如果未找到.adoc期望的代码段,则构建失败。
)