Top-bewertete Stoplight Alternativen
342 Stoplight Bewertungen
Gesamtbewertungsstimmung für Stoplight
Melden Sie sich an, um die Bewertungsstimmung zu sehen.
Ich mag den Markdown-Editionsmodus. Er ermöglicht es Ihnen, Ihre Dokumentation schnell zu schreiben, solange Sie Markdown beherrschen (was eine gute Investition ist). Es ist kein WYSIWYG-System, aber Sie werden mit mehreren Formularfeldern geführt.
Ein weiterer Vorteil ist, dass Ihre Dokumente nicht in der Anwendung gespeichert werden, sondern in einem Ihrer Repos als Standard-YAML-Dateien. Es ist so leistungsstark und hat zwei Vorteile: Sie können Ihr Dokument später überallhin mitnehmen (keine Bindung) und Sie können die Generierung von Code automatisieren (zum Beispiel können Sie Informationen aus anderen Quellen extrahieren, sie in die Dokumente integrieren und dann zurück zu Stoplight bringen). Bewertung gesammelt von und auf G2.com gehostet.
Bisher nicht viele Probleme. Vielleicht hat es die gleichen Probleme, die man in ähnlichen Tools finden kann: Man kann von den Optionen für jedes Feld oder jeden Eintrag überwältigt werden. Aber das ist normal, da man das Gleichgewicht zwischen Benutzerfreundlichkeit und Funktionen finden muss, besonders wenn man einer Spezifikation folgen muss, die nicht von einem selbst abhängt. Außerdem habe ich eine Möglichkeit vermisst, Webhooks auf die gleiche Weise zu dokumentieren, wie ich die API dokumentieren kann, aber das ist wahrscheinlich eher eine Einschränkung von OpenAPI als von Stoplight selbst. Bewertung gesammelt von und auf G2.com gehostet.
Wie alle anderen habe ich mit Swagger-Tools angefangen. Aber es war zu viel Code in YAML zu schreiben. Die Wartung war ein großes Problem. Es war ein großes Projekt. Ich musste mindestens 100 API-Endpunkte dokumentieren. Ich dachte, das Projekt würde mindestens ein paar Monate dauern, aber ich konnte es in der Hälfte der Zeit erledigen. Ich habe viel Zeit gespart und dem Kunden dank Stoplight viel weniger in Rechnung gestellt. Das erste, was mich beeindruckt hat, war, wie schnell Stoplight Desktop das Dokumentieren von APIs in OAS machte. Meistens musste ich keine einzige Zeile YAML oder JSON schreiben. Der Code und die Vorschau nebeneinander waren ein Lebensretter. Die Benutzeroberfläche des Desktop-Tools war außergewöhnlich und macht das Dokumentieren von APIs für jeden zugänglich, nicht nur für Entwickler. Das Erstellen von API-Support-Dokumenten war dank der vollständigen Unterstützung für Markdown unkompliziert. Bewertung gesammelt von und auf G2.com gehostet.
Nun, Stoplight ist ein wenig langsam, um Änderungen zu absorbieren, die zu OAS3 gepusht werden. Es gibt einige Funktionen, die auf Stoplight nicht verfügbar sind, obwohl sie schon lange Teil von OAS 3 sind. Ich erinnere mich nicht an diese. Bewertung gesammelt von und auf G2.com gehostet.
Ich mag die Möglichkeit, Formularfelder schnell auszufüllen, anstatt die YAML/JSON-Struktur von Hand eingeben zu müssen. Es ist auch sehr schön, Spectral direkt in das Tool integriert zu haben, da dies hilft, einen Teil des Designüberprüfungsprozesses zu automatisieren, indem die Notwendigkeit entfällt, die Kodierungsstandards bei der Gestaltung der APIs manuell zu überprüfen. Bewertung gesammelt von und auf G2.com gehostet.
Wenn neue Funktionen veröffentlicht werden, scheinen sie nicht gründlich getestet zu sein und verursachen gelegentlich Probleme. Es scheint auch eine Priorisierung von "Neue Funktionen herausbringen" über "Die bestehenden verbessern" zu geben. Die Implementierung von Spectral ist schön, aber es ist schwierig, bei Hunderten von Projekten ein konsistentes Regelwerk aufrechtzuerhalten. Bewertung gesammelt von und auf G2.com gehostet.
Es ist wirklich intuitiv und selbst für eine nicht-technische Person wie mich war es einfach zu verstehen und eine Dokumentation zu schreiben. Bewertung gesammelt von und auf G2.com gehostet.
Markdown ist wirklich begrenzt und schränkt die Möglichkeit ein, kreativere Dokumentationen zu erstellen. Bewertung gesammelt von und auf G2.com gehostet.
Lots of functionality that is available within stoplight, easy to use and merge changes! Bewertung gesammelt von und auf G2.com gehostet.
Typically they take long to respond to issues that we face. Bewertung gesammelt von und auf G2.com gehostet.
Stoplight ist ein sehr benutzerfreundliches Dokumentationswerkzeug, sowohl für die Erstellung von Dokumentationen als auch für Entwickler, um technische API-Dokumentationen zu nutzen.
Ich bin auch ein Fan ihrer detaillierten Benutzerberechtigungen, die es uns ermöglichen, Berechtigungen zu verwalten, welche Seiten Personen sehen können. Bewertung gesammelt von und auf G2.com gehostet.
Obwohl es keine Einschränkung in der traditionellen Art der Dokumentation von APIs ist, hätte ich gerne mehr Flexibilität im Design bei der Erstellung von Geschäfts-Persona-Seiten. Bewertung gesammelt von und auf G2.com gehostet.
Ich mag, dass Stoplight das OpenAPI-Format verwendet, um die APIs zu definieren. Ich konnte die Konfigurationsdateien auch in andere Dienste einbinden, um das API-Testing zu erleichtern. Bewertung gesammelt von und auf G2.com gehostet.
Ich liebe es nicht, dass GitHub erforderlich ist, um zusammenzuarbeiten und Ihre Arbeit zu teilen. Ich würde eine Kollaborationsmethode bevorzugen, die meine Änderungen automatisch speichert und meinem Team Zugriff zum Bearbeiten gibt. Außerdem nutze ich Azure DevOps täglich, habe aber ein GitHub-Konto für die Stoplight-Zusammenarbeit erstellt, weil es kostenlos war. Das hat mich aus unserem bestehenden Ökosystem herausgenommen. Bewertung gesammelt von und auf G2.com gehostet.
Die Benutzeroberfläche und die Verbindung zu Github und anderen Repositories. Die Struktur der Ordner und Projekte sowie der Bildschirm zum Bearbeiten und Hinzufügen von Informationen sind ziemlich einfach und benutzerfreundlich. Bewertung gesammelt von und auf G2.com gehostet.
Persönlich denke ich, dass die Möglichkeit von ereignisgesteuerter oder asynchroner API-Dokumentation fehlt. Bewertung gesammelt von und auf G2.com gehostet.
Die Benutzeroberfläche ist benutzerfreundlich. Die Verfügbarkeit von automatischen Mock-Servern erleichtert den Testprozess des Designs. Einfach mit Git-Workflows zu kollaborieren. Bewertung gesammelt von und auf G2.com gehostet.
Das einzige, was ich nicht mag, ist die Unfähigkeit, die Web-Service-Antwort anzuzeigen, wenn die Antwortzeit über 10000 ms liegt. Bewertung gesammelt von und auf G2.com gehostet.
