Discussions

Ask a Question
ANSWERED

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

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/>?
ANSWERED

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

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

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

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

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

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

How to add one more tab to subheading

I am trying to add one entry on sub heading next to guides , api reference , etc.
ANSWERED

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)