Discussions
Would be great to also draw graphs with a tool like mermaid
Sometimes its necessary to draw a graph in documentation, so it would be great if you could provide something like <https://mermaid.js.org/intro/>
Posted by ben 8 months ago
Rendered code is not working well when using multipart/form-data
Hello
I face an issue when using multipart/form-data and object in body. Here is snapshot of current openapi 3.0
![](https://files.readme.io/f430275-image.png)
The problem is with `initials` and its content: `alignment` and` y`
In documentation generated code looks like this:
![](https://files.readme.io/9957dc7-image.png)
In shell generated, we can see
`--form alignment=hello
--form y=10`
Whereas i would expect
`--form initials[alignment]=hello
--form initials[y]=10`
When using `application/json` instead of `multipart/form-data `is works very well, so i'm assuming this is a generation code problem related to `multipart/form-data`.
Within the same endpoint i'm also upload a file so i need to keep `multipart/form-data`
You can see our public doc here: <https://developers.yousign.com/reference/post-signature_requests-signaturerequestid-documents>
Could you help me one this one, or tell me when this will be fixed ?
Thanks
Posted by Flavien Du Peloux 8 months ago
Looking for recommendations for automatic Python API (docstring) to readme.io markdown pages
We host our API documentation on readme (see here: <https://docs.edgeimpulse.com/reference>). While we use the OpenAPI integration for our REST API, we are also working on generating and hosting Python API documentation for our Python SDK. At the moment, I have been learning and tinkering with sphinx and pydoc-markdown for markdown generation. Neither seems to provide the output required for readme without modifications to their code or some custom add-ons.
Does anyone have any recommendations on tools that can read Python docstrings to produce good API documentation hosted on readme?
Posted by Shawn Hymel 9 months ago
Endpoint not found when testing the Personalized Docs Webhook
Hi, I am trying to set the Personalized Docs Webhook for my application.
I added enpoint and served it with ngrok. I tested that endpoint through the Postman and it's giving me correct result. It's working. Here is the CURL:
curl --location --request POST '<https://8407-85-114-46-238.eu.ngrok.io/webhook>'
--header 'Content-Type: application/json'
--data-raw '{
"email": "test"
}'
But when I test it in the 3. step of Personalized Docs I am getting:
Endpoint not found!
Did you forget the path in your server URL (e.g., /webhook)?
With Network response:
400 status code and json response {type: "not-found"}
Can you provide me more information about why am I getting this response?
Posted by Lorena 9 months ago
startup accont: How toexpose my project to a limited external people
Hi All,
I have a startup account and would like to keep my project private. But, I want to share my project with 20 external users. What is the best option to achieve it?
Thanks,
Manish
Posted by Manish Gupta 9 months ago
Is there API Access availabe to the Discussions forum?
Eg. so we can get a list of current questions, and post responses to questions via the API?
Thanks
Ben
Posted by Ben 9 months ago
When trying to edit category through command, getting error 'unable to get local issuer certificate'
When trying to edit category through command, getting error
Command: rdme openapi --key=$README_API_KEY --id=$CATEGORY_ID
Error: request to <https://dash.readme.com/api/v1/api-registry> failed, reason: unable to get local issuer certificate
Posted by null 9 months ago
Including a page, footer, etc. in other pages.
Hi.
It seems like readme does not support 'including' a page, header, footer, etc. in other pages. (as in other tools like jekyll - <https://jekyllrb.com/docs/includes/>)
However, it would be much easier if we could handle any recurring parts in similar roles of pages - for instance, common 'if you have further questions' section in FAQ sibling pages - in 'include' fashion.
Is there a plan to support a function like this, or is there any well-known or officially-guided workaround to do this?
Thank you.
Posted by Bohyun Jung 9 months ago
Add Badges to indivdual API endpoint (like Alpha, Beta, Stable)
We are using Readme for our API documentation, we use OAS document to add the APIs Reference, now we want to Add Badges to indivdual API endpoint (like Alpha, Beta, Stable)
Posted by Akhil Agarwal 10 months ago
Collapse sidebar in editing mode?
Hi there!
Are there plans to allow users to collapse the sidebar in editing mode? It takes up a large chunk of screen space, especially for users with lower resolutions and/or smaller laptop screens.
Posted by Anon 10 months ago