Recomendações a outras pessoas considerando Open API Documentation for Confluence:
Sim, é realmente bom para documentar grandes produtos de software. Análise coletada por e hospedada no G2.com.
Que problemas é Open API Documentation for Confluence E como isso está te beneficiando?
Trabalho em uma empresa de desenvolvimento de software onde trabalho em vários softwares. Para cada software, temos o documento adequado, roteiro, diagrama de fluxo de arquitetura, esquema de banco de dados e muitos outros componentes relacionados. Usamos o Confluence para documentar tudo em um só lugar. O Confluence fornece modelos agradáveis para a criação de artefatos. Além disso, integramos com o stack Jira.
Os membros da minha equipe criam JSON ou YAML compatíveis com Open API, então geramos documentação bonita e interativa na página do Confluence. Além disso, ele fornece várias opções para fazer isso, podemos buscá-lo diretamente de uma URL fornecida ou colá-lo no corpo do macro.
Do próprio Confluence, podemos usar o modo interativo Try It Out! para testar as operações da API, corpo de resposta, códigos de status, cabeçalhos etc. Análise coletada por e hospedada no G2.com.