Discussions
Rendered code is not working well for a nullable object
Hello
I'm using OpenAPI 3.0
I have a **nullable **object `reminder_settings` wich is composed of 2 fields that are required **if **reminder_setting is set
So you can call the endpoint without having to set reminder_settings. But if you do so, you have to fill the 2 fields (`interval_in_days` and `max_occurrences`)
- `interval_in_days` is an enum
- `max_occurrences`is integer
![](https://files.readme.io/46933af-image.png)
When i load my documentation page, generated code is not working well since it already fills `interval_in_days` whereas it shouldn't because the `reminder_settings` is nullable.
And since both fields must be filled when `reminder_settings`is created it throws an error
![](https://files.readme.io/517e45b-image.png)
![](https://files.readme.io/0643fda-image.png)
Expected behavior: the `reminder_settings`json should not be present by default on generated code since it's nullable
How can i fix my problem ?
Thank you
Posted by Flavien Du Peloux 9 months ago
Hide Recipes
Is it possible to hide the Recipes menu option if I don't want to use it?
Posted by Charity Dominic over 1 year ago
How can I customize the Discussions CSS/Appearance?
Hey folks, I want to customize the CSS for the Discussions section, how can I do so? I don't see anything in the docs.
Posted by [email protected] over 1 year ago
Help! in setting the value of the email address input field on the contact field
Hey i am doing a form page in html so that the user that logged in will send me massages and i need to autofill the email field to the one who currently logged in to his readme account there is anyway to do so?
Best regards
Posted by Idan bn almost 2 years ago
Unable to render endpoints that $ref a file that has already been $ref by another endpoint
We've recently started to use readme.io, and we've run into a problem. It seems that readme.io is unable to render endpoints that include a `parameters` section that `$ref` a file that has already been `$ref` before.
When viewing pages for any endpoint that matches the above criteria, the page will show the error code `ERR-JUAMVC` with a message: "This reference guide is currently experiencing difficulties and will be back online shortly."
A truncated version of our YML file:
```yaml
'/users/{id}':
put:
parameters:
$ref: common/users/uid.yml
requestBody:
required: true
content:
application/json:
$ref: common/users/update.yml
'/users/{id}/resources':
post:
parameters:
$ref: common/users/uid.yml
requestBody:
content:
application/json:
$ref: common/users/create_resources.yml
```
In the case above, the file `common/users/uid.yml` is referenced inside two endpoints. The page for `PUT /users/{id}` renders successfully, but `POST /users/{id}/resources`fails to do so.
We've tried to use `redocly` to render the same above YAML file and it works without issues, and `rdme openapi:validate` also returns no error.
Could you help check what could be the cause of this issue?
Posted by Vu Hoang 11 months ago
Parameter contraints
Is there a way to automatically pull in the parameter constraints to the parameter description?
Currently, a user would need to click in each input box to see what the value constraints are.
Posted by Don Glover almost 2 years ago
Production not show parameters and response which is available in staging
Hi, I have staging and production API document, later I changed URL of the API and publish to git hub, staging got synced with new URL and parameter and response, but production show only URL changes but parameter and response is not available now.
Posted by Sujeet Kumar Sanger over 1 year ago
Refreshing/side nav is too laborious
Every time I edit something that affects the side nav, I have to refresh and when I do that I am returned to the top of the side nav and often have to spend some time hunting for where I left off in that nav. Sometimes, I get interrupted at that moment and totally lose my place and forget what I was doing so this is risky to my authoring process. Two things that would reduce the time and effort here: 1) Refresh the site whenever I save edits to a page that affects the side nav (a prompt to do that would be fine), and 2) Hold my place in that nav when refreshing.
Posted by Charity Dominic over 1 year ago
Multiple Gudies
I see on this site that there are multiple Guides in the menu navigation (Product Guides and Enterprise Guides)
Can someone advise me if/how I can do that on our own site, or does it need a higher plan (We're currently on the startup plan)
Posted by Sam Machin about 1 year ago
Side-wide password - Pass password through url param
For a documentation protected by a site-wide password control, is there the ability to pass the password somehow in a url parameter in order the user signs in automatically ?
Posted by Vincent Dieulesaint 8 months ago