Stoplight Avantages et Inconvénients

J'adore ne pas avoir à me soucier de trouver/construire des modèles pour un site de documentation - je peux simplement écrire mes documents et laisser Stoplight les héberger ! C'est facile et presque sans douleur. J'aime aussi la facilité avec laquelle il est possible de configurer les documents Stoplight comme un sous-domaine de mon site principal. Le site principal de mon entreprise est codelighthouse.io, et docs.codelighthouse.io pointe vers Stoplight. C'était à peu près aussi simple que de cliquer sur un bouton. Avis collecté par et hébergé sur G2.com.

Le seul point de douleur pour moi est que mon organisation exige la signature des commits, donc je ne peux pas envoyer mes documents sur GitHub directement depuis Stoplight - je dois les copier/coller et les valider manuellement. Ce n'est probablement pas un problème pour 98 % des organisations, et ce n'est même pas vraiment un gros problème pour la mienne. Avis collecté par et hébergé sur G2.com.

J'aime la flexibilité de l'outil. Surtout avec la capacité de créer des documents complexes aux côtés des outils API. Avis collecté par et hébergé sur G2.com.

L'éditeur peut être un peu déroutant parfois, avec des erreurs d'API ouvertes apparaissant même avec des schémas valides de temps en temps. Avis collecté par et hébergé sur G2.com.

Il est très facile d'ajouter de nouveaux points de terminaison en utilisant la spécification XML ouverte. Avis collecté par et hébergé sur G2.com.

Pour un utilisateur non-développeur, c'est un peu compliqué. Avis collecté par et hébergé sur G2.com.

La console de conception d'API visuelle et qu'elle s'intègre directement avec GitHub. Avis collecté par et hébergé sur G2.com.

Cela ne dispose pas d'intégrations avec des packages backend pour générer du code backend. Ce serait formidable d'avoir des générateurs automatiques pour NestJS, ExpressJS, FastifyJS, etc. Cela augmenterait la productivité par 10x. Avis collecté par et hébergé sur G2.com.

Le support client a toujours été vraiment bon et utile, j'aime vraiment cela. Avis collecté par et hébergé sur G2.com.

Certaines des dernières modifications, comme le bouton de pull GitHub, n'étaient pas intuitives à trouver au départ et la plateforme n'est pas toujours aussi intuitive.

L'organisation des fichiers lorsque vous éditez l'API est vraiment mauvaise et différente de celle lorsque vous partagez le lien. Avis collecté par et hébergé sur G2.com.

The company is misleading and its better to use alt software Avis collecté par et hébergé sur G2.com.

I don't have many issues with it, maybe sometimes it can get cluttered with poor user management Avis collecté par et hébergé sur G2.com.

Je peux tester mes points de terminaison et aussi mettre beaucoup de détails. Donc, cela sert à la fois pour la documentation et les tests. Avis collecté par et hébergé sur G2.com.

Je dois mettre à jour la branche chaque fois que je dois tester. Avis collecté par et hébergé sur G2.com.

La manière dont il vous donne la capacité de décrire les points de terminaison Avis collecté par et hébergé sur G2.com.

Parfois, il y a des erreurs mises en évidence qui ne sont pas faciles à supprimer. Avis collecté par et hébergé sur G2.com.

La possibilité de travailler soit au niveau de l'interface utilisateur uniquement, mais aussi de modifier le YAML brut. De plus, les surlignages d'erreurs et d'avertissements sont très bons, et la possibilité de générer automatiquement des réponses et des requêtes à partir de JSON est très utile. Avis collecté par et hébergé sur G2.com.

Le schéma de génération automatique peut être amélioré. Avis collecté par et hébergé sur G2.com.

L'interface conviviale, j'avais l'habitude d'écrire les spécifications de l'API ouverte en utilisant le bloc-notes donc Stoplight était un grand changement. Avis collecté par et hébergé sur G2.com.

L'interface a besoin de quelques améliorations en termes de couleurs, catégories, descriptions, etc. Ainsi que d'avoir une fonctionnalité d'importation à partir de .yml. Avis collecté par et hébergé sur G2.com.