Cela fait deux mois que ce profil n'a pas reçu de nouvel avis

CS

Chirag S.

Software Enginner II

Entreprise (> 1000 employés)

6/5/2022

"Documentation de l'API pour Confluence en un coup d'œil"

4.5/5

Qu'aimez-vous le plus à propos de Open API Documentation for Confluence?

1) C'est littéralement utile pour l'équipe de développement ainsi que pour les consommateurs finaux de visualiser et d'interagir avec les ressources API sans avoir de logique d'implémentation en place.

2) Fournit un seul endroit pour toute votre communication et brise les barrières de communication.

3) Sa fonctionnalité intégrée pour partager des pages avec d'autres membres de l'équipe est vraiment géniale. En conséquence, cela devient utile pour les autres travaillant dans un grand groupe.

4) Il est livré avec une sécurité de niveau entreprise. Avis collecté par et hébergé sur G2.com.

Que n’aimez-vous pas à propos de Open API Documentation for Confluence?

Certains utilisateurs se plaignent que tous ses aspects sont difficiles à apprendre immédiatement.

Lorsque plusieurs utilisateurs modifient le document en même temps, ils ne peuvent pas voir les changements se produire en temps réel jusqu'à ce qu'ils actualisent leur page. Parfois, cela peut entraîner une perte de modifications. Avis collecté par et hébergé sur G2.com.

Recommandations à d’autres personnes envisageant Open API Documentation for Confluence:

Oui, c'est vraiment bien pour documenter de grands produits logiciels. Avis collecté par et hébergé sur G2.com.

Quels sont les problèmes que Open API Documentation for Confluence résout, et en quoi cela vous est-il bénéfique?

Je travaille dans une entreprise de développement de logiciels où je travaille sur plusieurs logiciels. Pour chaque logiciel, nous avons le document approprié, la feuille de route, le diagramme de flux d'architecture, le schéma de base de données et de nombreux autres composants connexes. Nous utilisons Confluence pour documenter tout en un seul endroit. Le confluence fournit de jolis modèles pour la création d'artefacts. De plus, nous l'intégrons avec la pile Jira.

Les membres de mon équipe créent des JSON ou YAML conformes à l'API ouverte afin que nous générions une documentation belle et interactive sur la page confluence. De plus, cela offre plusieurs options pour le faire, soit nous pouvons le récupérer directement à partir d'une URL donnée, soit le coller dans le corps du macro.

Depuis le confluence lui-même, nous pouvons utiliser le mode interactif Try It Out! pour tester les opérations de l'API, le corps de la réponse, les codes d'état, les en-têtes, etc. Avis collecté par et hébergé sur G2.com.