• http://swagger.io/
• Swagger Code Generation
• → Open API Specification로 표준화됨.
• SpringFox - Spring & Swagger
• Swagger Annotations
• Why Is Swagger JSON Better Than Swagger Java Client? - DZone Java

• ReDoc : Swagger API 문서화.
• Documenting your API with OpenAPI (Swagger) and Redoc — Web Relay
• 페이지 내 검색과 더 유려한 UI를 제공해줌.

• https://rapidocweb.com/

• Swagger2Markup/swagger2markup A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.
• Swagger2Markup/swagger2markup-gradle-plugin A Swagger2Markup Gradle Plugin.
• Swagger2Markup/spring-swagger2markup-demo SpringFox 로 Spring Boot 문서를 test 시에 swagger.json 으로 생성하고, 이를 가지고 AsciiDoc을 생성한뒤 AsciiDoctor 를 통해서 다시 HTML/PDF 문서로 바꾼다.
• Static API Documentation With Spring and Swagger - DZone Integration

// Spring / Swagger 에서 swagger.json 을 파일로 뽑아내는 예제
 
@WebAppConfiguration
@RunWith(SpringJUnit4ClassRunner.class)
@AutoConfigureRestDocs(outputDir = "build/asciidoc/snippets")
@SpringBootTest(classes = {Application.class, SwaggerConfig.class})
@AutoConfigureMockMvc
public class Swagger2MarkupTest {
 
    private static final Logger LOG = LoggerFactory.getLogger(Swagger2MarkupTest.class);
 
 
    @Autowired
    private MockMvc mockMvc;
 
...
 
    @Test
    public void createSpringfoxSwaggerJson() throws Exception {
        //String designFirstSwaggerLocation = Swagger2MarkupTest.class.getResource("/swagger.yaml").getPath();
 
        String outputDir = System.getProperty("io.springfox.staticdocs.outputDir");
        MvcResult mvcResult = this.mockMvc.perform(get("/v2/api-docs")
                .accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andReturn();
 
        MockHttpServletResponse response = mvcResult.getResponse();
        String swaggerJson = response.getContentAsString();
        Files.createDirectories(Paths.get(outputDir));
        try (BufferedWriter writer = Files.newBufferedWriter(Paths.get(outputDir, "swagger.json"), StandardCharsets.UTF_8)){
            writer.write(swaggerJson);
        }
    }
...
}

• https://github.com/sourcey/spectacle
• Generate PDF from Swagger API Documentation | Baeldung