Stoplight Avantages et Inconvénients

I love how the end product looks and the try it out functionality. Avis collecté par et hébergé sur G2.com.

It's a shame that we aren't hosting the docs ourselves, so we're missing out on any SEO data we could be gathering. This is also one of the most difficult tools I've ever used in terms of authoring experience in my 10+ years as a technical writer. If I have to change something that resides in an existing module, I have no way of knowing where it's being reused throughout the docs, so I have to click through every page to make sure that the change I just made isn't providing incorrect information on a different page. It takes a LOT of trial and error for a new user to figure out where the page components live (like where to change the title, etc.) Avis collecté par et hébergé sur G2.com.

Interface utilisateur/expérience utilisateur impressionnante lors de la création de nouvelle documentation sur StopLight. Très facile à apprendre l'outil et on peut le maîtriser en une ou deux semaines. J'ai aimé l'interface utilisateur en déplacement pour tout appel API. Avis collecté par et hébergé sur G2.com.

Je sentais que l'outil manquait d'une fonctionnalité permettant d'appliquer un paramètre de sécurité/chemin particulier à plusieurs requêtes à la fois, comme on peut sélectionner plusieurs requêtes à la fois pour fournir les valeurs des paramètres de sécurité/chemin en utilisant le pointage et le clic. Avis collecté par et hébergé sur G2.com.

Les sites de documentation publiés sont une excellente fonctionnalité pour nous permettre de collaborer avec nos clients sur l'utilisation de l'API. Avis collecté par et hébergé sur G2.com.

Certains aspects de l'interface utilisateur de l'outil et de l'utilisabilité Avis collecté par et hébergé sur G2.com.

Un seul endroit pour toutes les définitions - modèles de données, spécification API pour les services internes et externes, ainsi qu'un excellent outil de rédaction - me permettant de créer une documentation convaincante pour nos développeurs internes et les développeurs tiers utilisant nos API. Avis collecté par et hébergé sur G2.com.

Il n'y a rien que je n'aime pas, mais il y a des points à améliorer. Cependant, ils continuent d'améliorer le produit et je suppose que la plupart des besoins seront satisfaits. Avis collecté par et hébergé sur G2.com.

J'aime que Stoplight prenne en charge l'importation de mon API via Swagger. Cela rend l'intégration précoce avec l'outil accessible. J'apprécie également que l'interface utilisateur m'aide à penser à toutes les parties de la création d'un nouveau point de terminaison et offre même des outils pour le mock. Avis collecté par et hébergé sur G2.com.

Parfois, cela peut sembler un peu accablant. Si une interface utilisateur de base existait, elle pourrait rapidement créer un prototype. Avis collecté par et hébergé sur G2.com.

Stoplight devient un outil essentiel pour nous alors que nous développons nos API. Stoplight rend la conception et la création de fichiers de définition Swagger / OAS vraiment faciles. Avis collecté par et hébergé sur G2.com.

L'interface utilisateur de la version "suivante" est un peu difficile à s'habituer. Ce serait bien si je pouvais regrouper les points de terminaison ensemble lorsque je les conçois, comme c'était possible dans la version précédente. Avis collecté par et hébergé sur G2.com.

La manière dont nous pouvons facilement concevoir notre API REST, déclarer nos ressources et modèles, et simuler cette API via Prism. Avis collecté par et hébergé sur G2.com.

Petit bug d'interfaces et actualisation, nous ne pouvons pas réorganiser le scénario sans entrer dans les paramètres du scénario

Peut-être une API pour obtenir le swagger avec un déclencheur sur un changement, afin d'automatiser la génération de contrôleur dans notre backend lorsqu'un changement est effectué sur le stoplight

La mise en œuvre de GraphQL serait également un grand plus

Prism plante aléatoirement sur certaines distributions Linux Avis collecté par et hébergé sur G2.com.

How simple it is to navigate the interface. Able to quickly add documents and push to production. Stoplight allows me to reference a new document to replace existing content. This makes it particularly helpful with version control. Avis collecté par et hébergé sur G2.com.

Hard to add media such as images. Often find it difficult to keep media organized in one location. Also difficult to update images without having to update it in various locations. Avis collecté par et hébergé sur G2.com.

Vous pouvez concevoir et tester contre la plateforme simulée de feux de signalisation tout en modifiant les réponses par service web. Avis collecté par et hébergé sur G2.com.

Si j'ai vraiment besoin de me plaindre, Parfois difficile de trouver le point de terminaison moqueur (UI) Avis collecté par et hébergé sur G2.com.

Swagger simplifié, enfin - plus d'excuses pour ne pas documenter complètement les API. L'interface utilisateur est intuitive, aucun tutoriel nécessaire. Je n'ai pas trouvé de cas que la documentation Stoplight ne pouvait pas couvrir. Avis collecté par et hébergé sur G2.com.

Il y a quelques problèmes avec le fait de devoir enregistrer une nouvelle définition avant de pouvoir les mettre à jour. Avis collecté par et hébergé sur G2.com.