Discussions

Ask a Question
ANSWERED

Can I get parent's category name or slug when calling 'getdoc' API?

Hi, I want to get parent's category name or slug when calling 'getdoc' API. <https://docs.readme.com/main/reference/getdoc> But, I can only see ids like '64ce3233....' in response and I do not know how to handle them.
ANSWERED

Must slugs be unique across both doc: and ref: domains?

If we have a Guide topic with a slug of slug-name, can we also have an API reference topic name slug-name (exactly the same)? So in linking, both (doc:slug-name) and (ref:slug-name) would exist. Or must a slug be unique across both the doc: and ref: domains? Thank you!
ANSWERED

Markdown links do not render `[example][1]\n[1]: http://example`

Standard links as supported by Github, Pandok, CommonMark and most other markdown tools don't seem to work in Readme.com, even if the documentation says \["The engine also supports all standard markdown constructs"][1] \[1]: <https://docs.readme.com/rdmd/docs/syntax-extensions#standard-markdown> For example from the following 3 links, none will render: ```Text Markdown Here are 3 styles of links that do not render: [example1][1], [example2][] and [example3][]. [1]\: http://example.com [example2]\: http://example.com [example3]\: http://example.com "link to example.com" ``` This style of links if far superior as it doesn't clutter the text with long links. What is the syntax to keep the link text and the URL separated in Readme.com markdown syntax? CommonMark relevant spec paragraph: <https://spec.commonmark.org/0.30/#link-reference-definition>
ANSWERED

Send multipart form data is form data rather than body data

Hello, Does anyone know how to setup an API Reference using the manual editor so that multipart/form-data generates a CURL statement similar to the following when a user is trying it out from the docs: curl -v --request POST --url [https://api.example.com/1.0/documents](https://api-dev.fusebank.io/1.0/documents) --header 'accept: multipart/form-data' --header "Authorization:$TOKEN" --header 'content-type: multipart/form-data' -F some_id=50dc5d68-fd81-457b-b3e4-ffe87969ce6a -F another_id=50dc5d68-fd81-457b-b3e4-ffe87969ce6a -F document_type=PHOTO -F [email protected] Thanks, James
ANSWERED

Multiple cosmetic issues with embedded video display

Hi, we're having troubles with embedded video in <https://docs.cast.ai/docs> Our welcome page has a video, and we're noticing few issues. iPhone/Chrome: video is missing a preview picture, mostly rendering a dark screen with play button. Macbook/Safari/4k screen: preview is rendered as mostly black screen with small thumbnail in it. Macbook/Chrome there's a weird autoplay behavior, to reproduce: 1. open docs.cast.ai 2. navigate away, e.g. click on "About the read only agent" 3. Click on "Getting started" again 4. Video starts playing automatically
ANSWERED

SDK Mobile Documentation

I can't find a document about sdk mobile documentation. How can I import sdk documentation from Github? Is it possible?
ANSWERED

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

Error Submitting form

When I update a Guide page, I get a message that says error submitting form. This happens after entering text and clicking the Save to Staging button. The page that I am working on is quite large with many tables. Do you have any ideas why I am getting this error and what I can do?

How to make linebreaks in markdown table cell using raw markdown (not block code)?

Hello, I am syncing .md files to ReadMe for my company's documentation. I am trying to create a markdown table in which the table cell's have line breaks. I have used tags in my markdown code, which works in normal markdown, but doesn't seem to work when I import it into ReadMe. The only way I can seem to get line breaks to work in ReadMe is to use the ReadMe table block. Do I need to change my .md to include that block format or is there another way?
ANSWERED

Search not working (but i have a suspicion)

Hey there! Happy new customer here! I am currently setting up our developer portal. So everything is set to "Admin only"-visibility. If i try to use the search; nothing shows up. Will this work once i have everything public? or is there an underlying issue? Greetings!