Discussions

Ask a Question

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
ANSWERED

Landing Page

How can I create and preview my landing page.
ANSWERED
ANSWERED

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!
ANSWERED

How to find Category ObjectId?

I want to update my documentation from local files. I'm using `npx rdme docs`, as specified in this recipe: https://docs.readme.com/recipes/sync-directory-of-files-via-cli However, it errors if I don't have the ObjectId of a pre-existing category for my project. I created a category in the readme UI but can't find the ObjectId anywhere on the UI. Where do I find the category ObjectId? Alternatively, how can I create a category using the API?

AsyncAPI specs

Can you please provide some guidance about how to handle documentation for websocket events? Do you plan to support AsyncAPI specs? Thanks very much!
ANSWERED

Is there any way to scroll a table?

In the editor, tables scroll. But they don't in the live Web page. Can I change this?
ANSWERED
ANSWERED

Is there a way to make it more clear when parameters have default values?

Currently, when viewing parameters, it's hard to tell at a glance which ones do and don't have default values. You can click the input element next to it and then select to use the default value if there is one, but I would prefer it if users could tell without clicking what a parameter's default value is.
ANSWERED