Top Rated Stoplight Alternatives
342 Stoplight Reviews
Overall Review Sentiment for Stoplight
Log in to view review sentiment.
I like the markdown edition mode. It lets you write your documentation fast, as long as you know Markdown (which is a good investment). It's not a WYSIWYG s system, but you will be guided with multiple form fields.
Another good thing is that your documents are not saved into the application, but into one of your repos as standard yaml files. It's so powerful and has two advantages: you are free to take your document anywhere later (no lock in) and you can automate the generation of code (for example, you can extract information from other sources, integrate it in the documents and then put it back to Stoplight) Review collected by and hosted on G2.com.
Not many problems so far. Maybe it has the same problems that you can find in similar tools: you can be overwhelmed by the options for every field or every entry. But it's normal, as you have to find the balance between usability and features, more when you have to follow a specification that doesn't depend on you. Also, I missed some way to document webhooks in the same way I can document the API, but again, it's probably more a limitation of OpenAPI than Stoplight itself. Review collected by and hosted on G2.com.
As everybody else, I got started with swagger tools. But it was writing too much code in YAML. Maintaining it was a big hassle.
It was a big project. I had to document at least 100 API endpoints. I thought the project would take at least a couple of months but I could do it in half of the time. I saved a lot of time and billed the client a lot less thanks to Stoplight.
The first thing I was impressed with is just how fast stoplight desktop made documenting api in oas. Most of the time I did not have to right a single line of YAML or JSON. The side by side code and preview was a life saver.
The UI of the desktop tool was extraordinary and makes documenting apis approachable to anybody not just developers.
Creating api support documents was straightforward thanks to complete support for markdown. Review collected by and hosted on G2.com.
Well Stoplight is a little slow to absorb changes pushed to OAS3. There are a few features unavailable on Stoplight despite being a part of the oas 3 for a long time. I don't remember those. Review collected by and hosted on G2.com.
I like the ability to quickly fill in form fields rather than having to type out the yaml/json structure by hand. It is also very nice to have Spectral baked right in to the tool as this helps us to automate some of the design review process by alleviating hte need to manually review coding standards around desinging the APIs Review collected by and hosted on G2.com.
When new features are released, they do not seem to be thoroughly tested and cause problems on occasion. There also appears to be a prioritization of "Getting new features out" above "Improving the ones that exist." The implementation of Spectral is nice, but it is hard to keep 100s of projects maintain a consistent ruleset. Review collected by and hosted on G2.com.
It´s really intuitive and even for a non-technical person like me, it was easy to understand and write a documentation Review collected by and hosted on G2.com.
Markdown is really limited and limits the possibility to create more creative documentation Review collected by and hosted on G2.com.
Lots of functionality that is available within stoplight, easy to use and merge changes! Review collected by and hosted on G2.com.
Typically they take long to respond to issues that we face. Review collected by and hosted on G2.com.
Stoplight is a very user-friendly docs tool for both generating docs and for developers to consume technical API documentation.
I'm also a fan of their granular user permissions which lets us manage permissions around which pages people can see. Review collected by and hosted on G2.com.
Although not a limitation in the traditional way of documenting API's, I would like more design flexibility around creating business persona pages. Review collected by and hosted on G2.com.
I like that Stoplight uses openAPI format to define the APIs. I've been able to pull the config files into other services for easier API testing as well. Review collected by and hosted on G2.com.
I don't love that GitHub is required to collaborate and share your work. I would prefer a collaboration method that auto-saves my changes and gives my team access to edit. Also, I use Azure DevOps day-to-day, but created a github account for stoplight collaboration because it was free. That took me out of our existing ecosystem. Review collected by and hosted on G2.com.
The UI and the connecction to Github and other repos. The Structure of the folders and project and the screen to edit and add information are pretty simple and easy to use Review collected by and hosted on G2.com.
Personally, I think that the possiblity of event driven or async api documentation is lacking Review collected by and hosted on G2.com.
The User Interface is friendly. The availability of Automatic mock servers eases the testing process of the design. Easy to collaborate with Git Workflows. Review collected by and hosted on G2.com.
The only thing that I dislike is the inability to display Web-Service response when the response time is above 10000 ms. Review collected by and hosted on G2.com.
