Please share with the community what you think needs improvement with Apiary.
What are its weaknesses? What would you like to see changed in a future version?
I would like to see an improvement in the access to portals. It should be more user-friendly. I also think the delivery patches should be updated more often.
I would like an integrated option to download a Swagger version of the definition. Currently, you can download an API Blueprint file that can be converted using other tools into OpenAPI or Swagger; however, built-in support would be ideal. We have also used other utilities for rendering the API Blueprint, such as Agilo, for offline documentation. It would be nice if there were an option for offline documentation within the product.
* Validation messages could be a bit clearer. * Autocomplete, particularly around open API would be nice, or even the ability to pop up the syntax spec.