title: What is the benefit of using Spring REST Docs comparing to Swagger
body: <p>Spring REST Docs was released recently and the documentation says:</p>
  
  <blockquote>
    <p>This approach frees you from the limitations imposed by tools like Swagger</p>
  </blockquote>
  
  <p>So, I wanted to ask when Spring REST Docs is preferable to use comparing to Swagger and which limitations it frees.</p>