Discussions
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.
Posted by Yunjae Jung about 1 year ago
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!
Posted by Chad Brotherton about 1 year ago
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>
Posted by Kevin about 1 year ago
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
Posted by James Smith about 1 year ago
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
Posted by Viktoras about 1 year ago
SDK Mobile Documentation
I can't find a document about sdk mobile documentation. How can I import sdk documentation from Github? Is it possible?
Posted by Talita C Paes about 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
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?
Posted by Meet Patel about 1 year ago
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?
Posted by Connor Chen about 1 year ago
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!
Posted by Björn Wewer about 1 year ago