|
|
|
|
|
by BearEatingBees
976 days ago
|
|
Wow -- this is quite impressive. I'm delighted to see new offerings in this space. Kudos to the team!
I spent some time tinkering with the deployed preview (https://docs.scalar.com). I liked the thoughtful implementation around customizations / versioning, etc. Some places I hit friction while exploring:
- It was tough to close the "Test request" window.
- I wasn't sure how to interact with the product without more trial and error. Two suggestions I thought might be useful:
1. Add OpenAPI linting to the editor. Right now it works with invalid specs as long as long the JSON is formatted correctly.
2. Allow users to import an example spec from the initial Getting Started page. (The editor is a good home for it, too, but I would have found it sooner). Disclosure: I'm a Redocly employee, but have managed doc projects in a variety of tools. This is a neat approach! Great work and congrats. |
|
> It was tough to close the "Test request" window. - I wasn't sure how to interact with the product without more trial and error.
Ah, this is great feedback. We can make it more clear with a button, as well that you can hit escape.
> Add OpenAPI linting to the editor. ah, great idea. will triage this and get this in.
> Allow users to import an example spec from the initial Getting Started page. In the getting started page we have "import url, paste swagger" & "petstore + tableau + cmc" examples to import by clicking.
Did you mean to add it to the editor?
Ah that's very cool, back in the day I always would install redocly instead of swagger UI, great work with Redocly :)
Again I really appreciate the kind words and your time.