Discussions
How can I link an image on a custom page
On a custom page, it's possible to add an image using the dashboard. However, I can't find a way to add a link to that image.
As a sidenote; is it also possible to add a video?
Posted by Erik Oosterwaal over 2 years ago
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.
We'd like to have more editorial control over images and be able to decide if they should be full width or not. Being able to easily add a class to an image along with custom CSS would provide a lot more flexibility to control the layout of different images.
Posted by Mark Zeman over 2 years ago
Filtering "Contacts - Custom Fields Values"
Hi everyone!
I'm trying to use API of Active Campaign to get all the "Contacts - Custom Fields Values" but regarding that, the only way to filter for now is by "fieldedid" or "value" of the custom fields, it's impossible for me to do it.
Do you know whether there is a way like in"Contacts" to filter by creation or update date?
Kind Regards,
Daniel
Posted by Daniel Ruiz over 2 years ago
Testing XML endpoints using API Explorer
Live testing of API endpoints using the API Explorer(API Reference Page) basically supports RESTful endpoints, is there a way to test XML endpoints?
Thanks
Posted by Chigbogu Orji over 2 years ago
allOf inheritance
Hi,
it seems like when returning an array, and the associated schema is inherited with `allOf` the object is not properly displayed when you click on the "Response" to see how it looks.
Strangely, it works with non array.
example below:
responses:
200:
description: OK - List of advertiser objects
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/advertiser'
advertiser:
allOf: # Combines the basicAdvertiser and the advertiser model
- $ref: '#/components/schemas/basicAdvertiser'
- type: object
Posted by Mickael Maitre over 2 years ago
readOnly properties
Hi,
i see that readOnly properties are part of OpenAPI 3.0.3, that you support, but when I use your site they are not handled correctly.
Intended behaviour of a readOnly property:
1) not being display in body params
2) being displayed in the response body and in the example
same property in editor.swagger.io behaves correctly
is there any plan to fix it ?
thanks in advance
Posted by Mickael Maitre over 2 years ago
Upload multiple images at once
Is there was a way to upload all of the images I need for my team's guides into ReadMe at once? In previous Markdown-based doc repos, I've seen things like an "attachments" folder, where you can upload all of the things you want to link to in your docs - is there any feature like that in ReadMe? I've also seen the suggestion in [this post](https://docs.readme.com/discuss/60ef30cc442bc901a01f3aaa) that we can host our images on a separate site like Imgur, but it would be much more convenient for my team if we were able to keep all of our images on ReadMe.
Thanks in advance!
Posted by Sarah Eberhardt over 2 years ago
oneOf rendered as pulldown in API Reference, but Selection Doesn't Update Displayed Schema
In my OAS 3.0 spec, I have a number of oneOf's specified. They render in Readme.com as pulldowns, with the first object defined in the oneOf block selected, and its schema displayed.
When a different selection is made in the pulldown, I would expect that the pulldown updates its value, and the schema for the previous selection is replaced by the schema for the new selection. However, this is not occurring.
What is the expected behavior when a new selection is made in a pulldown? If the pulldown is supposed to update and the schema for the new selection is supposed to replace the old selection's schema in the display, is there an example spec I can review to see what I may be missing in my spec?
Thanks!
Posted by Taylor Murphy over 2 years ago
Slack Integration
Slack integration works for suggested edits but will not send notifications for Discussion questions. Any thoughts on how to fix this?
Posted by Jacob Moore over 2 years ago
What kind of validation is run on spec upload?
I'm getting this validation error:
```
The spec you uploaded has validation errors that must be addressed. Here's what we found:
Validation failed. /paths/authentication-settings/saml-metadata-upload/put has a file parameter, so it must consume multipart/form-data or application/x-www-form-urlencoded
```
I tried validating my spec against the json schema for swagger 2 from here : https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v2.0/schema.json and it validated successfully. So my question is what extra validation does readme.com does on swagger spec?
Posted by Ankush over 2 years ago