We should look at using running sample code imported into our .adoc files to prevent issues like #6312. Spring Security has done this already.
Comment From: snicoll
That and actually testing them would be nice to ensure backward compatibility.
Comment From: wilkinsona
I've done it in REST Docs too. It's not too arduous.
Comment From: wilkinsona
I've made a (tiny) start on this. See in ccaa19d.
Comment From: philwebb
Marking this one as complete but we might need to do the same with Gradle/Maven docs.