Right now there is a big comment at the top of QueryDSLDocumentationTests saying that we hope that they lines in there match the docs in the java API documentation. We should really use the include-tagged::{doc-tests}/DeleteDocumentationIT.java[delete-request] style syntax to include it directly into the asciidoc. The tags that you'd end up putting in QueryDSLDocumentationTests would make it super clear that this file is included in documentation. That way someone who missed the comment won't break the tests.