Discussions
Unusual rendering of enum values in Response objects
I've noticed that enums render a little funny in the response schemas generated for the API Reference.
![](https://files.readme.io/a6b4139-image.png)
Can anyone help me understand why all but the first value of the enum seem to be consistently re-rendered at the bottom of the enum? Here we see 1 here, which really isn't serving any purpose I can understand. I've uploaded the same schema in other products and they don't render the extra row at the bottom here.
An example of the relevant YAML is attached for review:
customer_type_name:
enum:
- 0
- 1
type: integer
description: |-
_ `0` - Personal
\_ `1` - Business
readOnly: true
Thanks for any advice.
Sample from Redoc below, which shows both values for the enum:
![](https://files.readme.io/cef98f6-image.png)
Posted by Brian Swanson 12 months ago
Automating openapi sync with circleci
Is there any method like <https://docs.readme.com/main/docs/github-actions-openapi-example> but for <https://circleci.com/>?
Posted by Ben Rosand 12 months ago
Adding line breaks to markdown tables synced via RDME tool
Hi,
Is it possible to include line breaks in markdown tables synced via the RDME tool?
You used to be able to use <br> tags to include line breaks in markdown tables, but that doesn't seem work anymore.
Any guidance on the exact behavior of tables in the Readme editor/sync would be greatly appreciated.
Posted by Thomas Harrington 12 months ago
How to "Add Markdown Content" to OpenAPI content?
Hello,
I am interested in the following feature, but it's not clear to me how to actually do this:
<https://docs.readme.com/main/docs/openapi#adding-markdown-content>
Can anyone point me to instructions for how to actually accomplish this?
Please note that we manage all of our content in a GitHub repo and use the CLI to import both markdown files and the OpenAPI JSONs, so I'd need to know the flow for how to use this feature given our constraints.
Thank you all for your time!
Posted by Chad Brotherton 12 months ago
Disable click on image
Hiya! Clicking on an image in the Guide opens the image in a popout window. This is helpful if it's a small screenshot, but kinda useless if it's just an icon. Is there any way to turn of click-to-open on images, so the user can't click an image that shouldn't be clicked?
Thanx!
Posted by Alan Baklor 12 months ago
add summary o description over tag
im working with opeanpi 3.0.3 and i would like to add a custom description for root tag like a "payment link" see image
![](https://files.readme.io/a7a2dba-image.png)
it is posible ?
Posted by Franklin carrero 12 months ago
Help me! restore deleted devices
Hi !
I have accidently deleted the wrong page and I really don't any way to restore it. Can you please assist?
Posted by Chen about 1 year ago
UUID of API Reference Pages
Hi!
The help for the "Retrieve an entry from the API Registry" for the required UUID property API states:
> An API Registry UUID. This can be found by navigating to your API Reference page and viewing code snippets for Node with the api library.
What does this mean? Do we navigate to the page in the Editing UI? In the external facing page?
Is there more information in the doc about "viewing code snippets for Node with the api library"?
I do find "\_id" in the page source for the API reference page in question, but it returns a 404 when I use that as the UUID.
Thanks for any insight you can provide!
Posted by Chris Cosentino about 1 year ago
How to add one more tab to subheading
I am trying to add one entry on sub heading next to guides , api reference , etc.
Posted by Aniket about 1 year ago
Manage Content as Code (CaC) - Readme Terraform Provider
Our team is heavily reliant on Terraform for Infrastructure as Code. We wanted to be able to manage our Readme documentation in a similar Content-as-Code fashion within our pipelines but there wasn't an easy way to do that. We spent some dev cycles on building a proper TF provider for Readme that enables managing guides, API references, categories, images and so on. We have recently published it to the public domain and welcome feature contributions from the greater Readme community.
[Readme Terraform Provider](https://registry.terraform.io/providers/LiveOakLabs/readme/latest/docs)
Posted by Brant Wellons about 1 year ago