Discussions

Ask a Question
ANSWERED

Sync Docs to GitHub When Making Edits in ReadMe

Is there a way to connect our product Doc markdown files to GitHub when we make edits in the ReadMe platform? Our team wants to ensure we have records in multiple places and I am having trouble figuring out how to set it up?
ANSWERED

Discussion Tags

Can an end-user non-admin add a tag to their questions?
ANSWERED

Bug: page title double encoding

If I use an apostrophe in the title in a guide page metadata, it turns into ' in the browser tab title on the guide public page. It happens because the title is HTML-escaped 2 times, therefore I get the result of the first escaping in the browser tab.
ANSWERED

API reference of an TypeScript library

What's the recommended way of documenting a TypeScript library in readme? I have a library written in TypeScript and I would like to publish an API reference for it, something like the one for reactjs: <https://react.dev/reference/react>. Up to now, my API reference is generated with typedoc, exported to HTML files and exposed as a web page to the public. Our company policy is to use readme for all documentation related tasks. I tried to exported the API reference to markdown using typedoc plugin and importing it into readme, but the layout doesn't look great and is not readable at all.
ANSWERED

Can Recipes be programmatically added?

If I wanted to add a recipe programmatically, is there a way to do that?
ANSWERED

Pass JWT/API Key in request body via POST for Custom Login

In the <https://docs.readme.com/main/docs/custom-login-page> example, we're shown an example of passing the JWT through the URL when redirecting back to a project's docs page. Is there support for passing this data through a POST request body? Or any other ways outside of including the token in the URL params?

Replace example.com in api sync

Similarly to [this issue](https://docs.readme.com/main/discuss/60c38ce69f926600450f3048), I am using an autogenerated openapi file from FastAPI, and don't see why there isn't an easy way to manually set the api endpoint for the generated docs, or at least sync with whatever endpoint the openapi file is retrieved from. This feature is blocking us from using the built-in request flow, a pretty big issue for our users. Is there any fix coming or available?
ANSWERED

Code block within a table

Is it possible to add a code block within a table?
ANSWERED

Unusual rendering of enum values in Response objects

I've noticed that enums render a little funny in the response schemas generated for the API Reference. ![](https://files.readme.io/a6b4139-image.png) Can anyone help me understand why all but the first value of the enum seem to be consistently re-rendered at the bottom of the enum? Here we see 1 here, which really isn't serving any purpose I can understand. I've uploaded the same schema in other products and they don't render the extra row at the bottom here. An example of the relevant YAML is attached for review: customer_type_name: enum: - 0 - 1 type: integer description: |- _ `0` - Personal \_ `1` - Business readOnly: true Thanks for any advice. Sample from Redoc below, which shows both values for the enum: ![](https://files.readme.io/cef98f6-image.png)
ANSWERED

Automating openapi sync with circleci

Is there any method like <https://docs.readme.com/main/docs/github-actions-openapi-example> but for <https://circleci.com/>?