Discussions

Ask a Question
ANSWERED

Templating

I'm curious if there's a way to implement a template in Readme? The use case is that I create a content in which that content can just be reference to different pages. Illustration: ``` <template id="contact-us">Contact Us</template> Guide: How To Write Writing is.... Need more help? <template/> Guide: How to Run Running is... Need more help? <template/> ``` In this way I will not copy-paste "Contact Us" content whenever I need it. And if I need to update Contact Us i will just update the source.
ANSWERED

Can a page show endpoint object

Can we show a page with endpoint object rendererd from OAS ? Similar to the below example where accounts endpoint shows a page (section) with account object ? <https://stripe.com/docs/api/accounts/object#account_object> Thanks for your help.
ANSWERED

I forgot which email I used to manage my readme account can I know it?

Is there a way to recover email/username?

Why does the API URL title on the sidebar of my API documentation keep changing?

I keep changing the title from API URL to API Documentation because I wanted to change the way it looked and it keeps returning back to API URL. I change the text, it saves it automatically and then I check on the preview of my documentation site, but when I come back the next day, it is back to API URL. I am the only person writing API documentation and none of the other two on my account have changed anything. What's going on? Am I not supposed to change that text?
ANSWERED

Different alt text with the image widget?

The image widget uses the same text for the caption of a figure and for the alt text of the image. However, you might want different text, because these items have different audiences. You might use a brief description for the caption and a more detailed description for the alt text. I know I can specify alt text via "plain" markdown: ``` ![This is alt text](https://example.com/path/to/image.png) ``` But then I lose the benefits of the image widget. Is there any way to do it?

When trying to edit category through command, getting error 'unable to get local issuer certificate'

When trying to edit category through command, getting error Command: rdme openapi --key=$README_API_KEY --id=$CATEGORY_ID Error: request to <https://dash.readme.com/api/v1/api-registry> failed, reason: unable to get local issuer certificate
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.

Left menu items - ordering

What is the logic used to order the openapi tags in the rendered page? Is there a way to influence the order of the pages in the left menu? I read this: <https://docs.readme.com/main/docs/openapi-categories-pages-subpages#tags> - but I still don't understand how is the order of the menu in the left defined. Let's say I have the following tags in my `openapi.yaml`: ``` tags: - name: Page1 - name: Page2 - name: Page3 ``` What I want is, to have menu items in the left pane of the docs page ordered in the same order as I specified in my `openapi.yaml` file. Currently the order is not preserved and I can't understand what algorithm is used to detect the order.
ANSWERED

How do you add an image using the new community discussions editor?

I cannot see a way to add an image to help explain my problem.... <https://v.usetapes.com/yLjdvMHiiJ>
ANSWERED

Moving a section from Refrence to the Guides

I moved a section from the Reference to the Guides, it move the section header and the first document in the section, but I now cannot find the subtopics that were attached to the first topic. Where did they go?