Document RESTful services by combining hand-written documentation with auto-generated snippets produced with Spring MVC Test, WebTestClient, or REST Assured
Arnold's First Law of Documentation:
If it should exist, it doesn't.
Arnold's Second Law of Documentation:
If it does exist, it's out of date.
Arnold's Third Law of Documentation:
Only useless documentation transcends the first two laws.