Hey! Because of the way our system works, we are going to need to push update swagger files to readme. What this looks like manually is me continually updating the Swagger links. I'm worried this won't be scalable. Is there a way for us to push are swagger file updates to Readme automatically? Thanks!
Posted by MacKenzie Alessi 2 years ago
Posted by Jimmy 2 years ago
I am trying to evaluate Readme.io as an API documentation tool, but at the moment I cannot import the Modulr API which is the crucial first step... The swagger url: https://modulr-technology-ltd.cloud.tyk.io/portal/apis/598829b39547c1000111d4f1/documentation/raw The error I get on import is: 'Invalid swagger file...' '...is not a valid JSON schema' I was able to successfully import the 'pet store' swagger (http://petstore.swagger.io/v2/swagger.json) I have validated using a couple of external validation tools, so am not sure why there is an error.
Posted by Gareth Faull 2 years ago
Our API needs two headers, `Accept-Version: v2` and `Authorization: Bearer [JWT]` (where `[JWT]` is a token the user has to fill in). Both are set in our "API Settings" and working as expected when using the "Try It" feature. But the headers are missing from the auto generated code. As a result, the auto generated code does not work as-is. The user has to add the headers manually which is not at all obvious. I _could_ add these headers manually, but doing so for every single endpoint it tedious and error prone. How can I tell readme.io to add the headers to the auto generated code automatically?
Posted by Stefan Schüßler 2 years ago
Hi there, dunno if this is a Feature-Request or Bug. (I'm speaking about **Reference API**.) I believe that if I pin an image to sidebar it should be placed where it was defined. Instead, it is always placed at the very beginning of a page. Pictures will follow in the next comment. Kind regards, Nobo Nadie
Posted by Nobo Nadie 2 years ago
I am clicking "save" after I load each individual document and I am still having an issue where I select to load a document and it replaces a previously loaded document This has been happening for a long time ..it is very difficult to even figure out which prior document it is replacing without reviewing the entire page
Posted by Julie Stoshak 2 years ago
When writing our readme guides in markdown, we break our lines after every sentence or so to increase readability in our editor. However, when I paste these markdown files into the readme.io editor, the html gets parsed in a way that there is a break after each of these line breaks. example: this is a long line so we break it up, but if the browser window is large enough we'd like it to have natural wrapping. Becomes: this is a long line so we break it up, but if the <br> browser window is large enough we'd like <br> it to have natural wrapping. <br> Is there a way to have normal paragraph wrapping in the html without having to put every paragraph on a single line in our markdown files? Usually paragraph breaks are denoted by an empty line in markdown, but that does not seem to be the case here. Thanks!
Posted by Tommy Crumrine 2 years ago
Hi all, Is it possible to have a comments section in knowledge base? it's really convenient for users to ask questions right on the page after reading articale/doc page. If something isn't clear in a documentation, the user can ask the question in the comments section after article and someone can answer for it, later doc owner can collect answers and questions and improve the documentation.
Posted by Mike 2 years ago
I am working with API Settings that are defined in the Reference Settings section (https://dash.readme.io/project/openbouquet/v4.2.53/reference). I have two sets of settings (let's call them, setA and setB). Both have two parameters (token and your_server). Under setA (working), the "your_server" has the type drop-down set with no value, while the "token" has the type drop-down set with Query. setB (not working) has "your_server" defined but it is not possible to choose no type, I must choose Query or Header. "your_server" is used in this way: https://[[app:your_server]]/release/v4.2/rs Also, if I try to change the "setA" settings (for example, call them "setC") then I get the error: "Validation Failed `manual` is not a valid enum value for path `in`." Unfortunately, there is no explanation of how to setup these additional API settings: https://readme.readme.io/docs/additional-api-settings How can I make "your_server" get a type of "none" (or "manual") and get readme.io to accept this parameter?
Posted by Jeffrey Edison 2 years ago
Posted by Philip Arambula 2 years ago
For the open source plan, is it possible to locally host an installation of readme on our own servers and to point it at a specific domain? I haven't seen any documentation on this, and would love to learn more!
Posted by austin truchan 2 years ago
Good afternoon. I have some questions about your product. 1- What is the maximum limit of categories, pages and other objects a project can contain? (Developer Hub) 2- Is there a size limit for my Redme.io site? 3- Do you have a support in Brazil? Or is there a support channel in Portuguese? 4- On the "support" page, when I register a call a warning arrives in my email. Is this configurable? Is this a readme.io native facility?
Posted by Edson Souza 2 years ago
Hello, I'm working on a page which includes several identical titles (H2, H3 for instance). The hyperlinks I've created manually point to the same title on the page. I don't want to change my titles to maintain coherent topics. I see nothing in the raw mode to change manually. Can you help me? Thanks.
Posted by Flora Collado 2 years ago
In the Project Dashboard I disabled the Support module (hovered over the Support module and toggled from Enabled to Disabled), but the Support link still displays on my main page and it opens a 404. How do I remove 'Support' from my project entirely?
Posted by Diana Neece 2 years ago