I used SpringRestDocs (spring.io/projects/spring-restdocs) plus Asciidoctor and couldn't be more happy
You can write your documentation manually and include snippets generated from your test. You can assert the test to align the request/response with the documentation and fail if some of them is not what the documentation expects
We're a place where coders share, stay up-to-date and grow their careers.
We strive for transparency and don't collect excess data.