Discussions

Ask a Question
ANSWERED
ANSWERED

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

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

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

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

Moving a page to a newer version

Hi. Novice user here. I created a new page in a live version of our guide and then made that new page live, not realizing that another editor had already branched a new draft version. Several days later that draft was published, thus removing my new page from our live site. My question is how do I move that page to the new version? I can see that dragging and dropping the page within the old version is easy, but I can't seem to drag it into the new version and republish it live. Do I have to recreate the page in its entirely or is there a way to drag or clone it to the currently live version? Thank you,.