Discussions
Is there a way to author in VS Code
Our team would like to continue authoring in Visual Studio Code and then let Jenkins pull the guide topics from our Git repository for staging/QA/GA. I did not see a way to add a CLI command to Jenkins or a plugin.
Support for Discriminator
Hi there,
I have multiple environments for a given api
I have multiple environments for a given api with different endpoints. For the logged on user, I am pre populating an apikey via custom login JWT.
Working OpenAPI spec parser/linter?
What tools are people using to validate their OpenAPI specs before uploading?
swagger file import issue
Hi When i try to import a swagger file , i am gettign the below error:
Is there a way to upload or manage an XML Sitemap with ReadMe?
I would like to create and manage an XML Sitemap of our Docs website with, which uses ReadMe. Is there an option to manage an XML Sitemap or upload an XML file to a subfolder?
Is there a plan to support the null type in OAS 3.1?
One of the changes from OpenAPI 3.0 to 3.1 was removing the nullable
keyword in favor of allowing type
to be an array, and having null
as a type there. The places our schema uses this seem to render in the docs unexpectedly, as "nullstring" in the response detail view, and ""Unknown Type: null,string"" in the example response.
How to add font-awesome icons or similar items into a cell in a table?
I want to add a checkmark into a table. Can someone point me to an example how to do so? Thank you!
Endpoints experiencing difficulties
Hello, the API Reference have two endpoints displaying this message since yesterday: "This endpoint's documentation is currently experiencing difficulties and will be back online shortly.", and I've not found anything similar to resolve this issue. I need to know what kind of problem it is. Thanks!
Extend image upload tool to add a class
The image upload tool is great but seems weirdly limited. Adding extra fields for class name and alt text would vastly improve the experience of editing docs.