Discussions
Dark mode support
We were thinking to migrate to Readme and because our previous system has dark mode support, we were thinking if this is planned.
Developers staring at night on a bright documentation is something very unpleasant.
Posted by Aditya about 2 years ago
Is there a way to expand or hide content?
In my organization's API guides, we sometimes need to list a lot (like, 30) API endpoints, which all are related to a specific functionality. Including such a list to a table or in the document body has a real negative impact on readability.
In our internal wiki (Confluence), I can create a table with an expand macro, so the user can toggle between viewing and hiding the list of endpoints.
Do you have any suggestions on how to work around this in ReadMe?
Posted by Katri Metsävuo almost 2 years ago
Let customers download open api spec
The admin dashboard has a way to export the api to oas spec file
But it doesn't seem like there's a way for the public facing api spec page to download an oas json file
That would be useful for customers if they prefer exploring the api with tools like Postman etc
Posted by Michael De Razon about 3 years ago
3-level nested TOC - Possible?
Beyond the page and then a page nested under it, is it possible to create a third hierarchical level?
Something like this:
Page - Level 1
Nested Page - Level 2
Nested Page - Level 2
Further Nested Page - Level 3
Page - Level 1
Posted by Paula Stern almost 3 years ago
Download a csv or zip file
Is there a way to embed a download link in the documentation?
Posted by Dustin Boswell almost 2 years ago
Enum value used as example appears twice in combo box
Hello,
When declaring in my OpenAPI spec a field such as:
```
"carColor":{"type":"string","example":"WHITE","description":"Color of the car","enum":["WHITE","BLACK","BLUE"]}
```
... then the field appears in Readme with a combo box with the possible values: `WHITE`, `WHITE`, `BLACK`, `BLUE`. If I select the first `WHITE` value, it won't be included in the generated JSON in the right pane (it does work with the other values).
Is there a way to have this value appear only once, be included in the generated JSON and still keep this value as an example?
Thank you,
Eric
Posted by Eric T over 2 years ago
Upload multiple images at once
Is there was a way to upload all of the images I need for my team's guides into ReadMe at once? In previous Markdown-based doc repos, I've seen things like an "attachments" folder, where you can upload all of the things you want to link to in your docs - is there any feature like that in ReadMe? I've also seen the suggestion in [this post](https://docs.readme.com/discuss/60ef30cc442bc901a01f3aaa) that we can host our images on a separate site like Imgur, but it would be much more convenient for my team if we were able to keep all of our images on ReadMe.
Thanks in advance!
Posted by Sarah Eberhardt over 2 years ago
Is there a way to add comments using Readme's markdown?
I'd like to add a comment to a topic in readme that internal users will be able to see, but that will not get picked up and published, such as:
..
internal RST comment
<!--- internal GitHub markdown comment --->
<!--internal HTML comment-->
Is that possible in a ReadMe file? I'm not seeing anything in the markdown reference, and would like to avoid trial and error if possible.
Posted by Alison almost 3 years ago
Quick and easy way to copy paste into a table
Hi! Just wondering if there is an easy way to copy and paste tables from one document (Word, Spreadsheet) into ReadMe?
Posted by MJ over 2 years ago
Syncing via CLI: "Path `category` is required."
Hi there!
I'm trying to sync a folder of markdown guides up to Readme.
My documents all have the [required header](https://docs.readme.com/docs/importing-documentation#expected-file-format) (title, excerpt) and are otherwise plain markdown in a flat directory structure (ie. they're all in one folder with no subfolders).
```
$ npx rdme docs docs/guides --key={MY_KEY} --version=1.0
> We couldn't save this doc (Path `category` is required.).
```
I'm not really sure what that error message means... Where should I put a category? Should they be in a particular subdirectory?
Posted by Oliver Fawcett over 2 years ago