Raccomandazioni per chi sta considerando Open API Documentation for Confluence:
Sì, è davvero utile per documentare grandi prodotti software. Recensione raccolta e ospitata su G2.com.
Quali problemi sta risolvendo Open API Documentation for Confluence e come ti sta beneficiando?
Lavoro in un'azienda di sviluppo software dove mi occupo di diversi software. Per ogni software, abbiamo la documentazione adeguata, la roadmap, il diagramma di flusso dell'architettura, lo schema del database e molti altri componenti correlati. Usiamo Confluence per documentare tutto in un unico posto. Confluence fornisce modelli utili per la creazione di artefatti. Inoltre, lo integriamo con lo stack Jira.
I membri del mio team creano JSON o YAML conformi a Open API, così generiamo documentazione bella e interattiva sulla pagina di Confluence. Inoltre, offre diverse opzioni per farlo: possiamo recuperarlo direttamente da un URL fornito o incollarlo nel corpo del macro.
Da Confluence stesso, possiamo utilizzare la modalità interattiva "Provalo!" per testare le operazioni API, il corpo della risposta, i codici di stato, gli header, ecc. Recensione raccolta e ospitata su G2.com.