{"id":16136,"date":"2021-11-12T10:16:19","date_gmt":"2021-11-12T10:16:19","guid":{"rendered":"https:\/\/www.cherryleaf.com\/?p=16136"},"modified":"2021-11-12T10:17:24","modified_gmt":"2021-11-12T10:17:24","slug":"podcast-118-whats-up-redocly","status":"publish","type":"post","link":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/","title":{"rendered":"Podcast 118: What&#8217;s up Redocly?"},"content":{"rendered":"<p>Cherryleaf&#8217;s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation.<\/p>\n<p>More information:<\/p>\n<p><a href=\"https:\/\/redoc.ly\/\">Redocly<\/a><\/p>\n<p><a href=\"https:\/\/quiz.tryinteract.com\/#\/60c1f67845a1300017b207f0\" target=\"_blank\" rel=\"noreferrer noopener\">What is your developer portal\u2019s KPI score?<\/a><\/p>\n<p><iframe loading=\"lazy\" style=\"border: none; min-width: min(100%, 430px);\" title=\"118. What\u2018s up Redocly?\" src=\"https:\/\/www.podbean.com\/player-v2\/?i=saafs-1112e15-pb&amp;from=pb6admin&amp;square=1&amp;share=1&amp;download=1&amp;rtl=0&amp;fonts=Arial&amp;skin=1&amp;font-color=&amp;btn-skin=7&amp;size=300\" width=\"100%\" height=\"300\" scrolling=\"no\" allowfullscreen=\"allowfullscreen\" data-name=\"pb-iframe-player\"><\/iframe><\/p>\n<p>Transcript<\/p>\n<p aria-level=\"1\"><span data-contrast=\"none\">Audio file<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559738&quot;:240,&quot;335559739&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><a href=\"https:\/\/cherryleaf-my.sharepoint.com\/personal\/ellis_cherryleaf_com\/Documents\/Transcribed%20Files\/redocly-final.mp3\"><span data-contrast=\"none\">redocly-final.mp3<\/span><\/a><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p aria-level=\"1\"><span data-contrast=\"none\">Transcript<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559738&quot;:240,&quot;335559739&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 2<\/span><\/p>\n<p><span data-contrast=\"auto\">This is the Cherryleaf podcast.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Hi everybody, welcome to the Cherryleaf podcast. I&#8217;m Ginny Critcher and I will be talking to Ellis Pratt today. He&#8217;s going to talk a little bit about our experience using Redocly on a recent project.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Oh maybe y<\/span><span data-contrast=\"auto\">ou&#8217;d like to start off by giving us the background.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, we did a project recently. A documentation project in house for a startup in America and they decided they were going to use Redocly as the platform for creating their developer portal.<\/span><\/p>\n<p><span data-contrast=\"auto\">And Redocly is a fairly new p<\/span><span data-contrast=\"auto\">latform, the developer portal bit of it is still in officially in beta.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">It&#8217;s getting more attention in recent times. It&#8217;s the first time we&#8217;ve used it, so I thought it might be useful to talk about our experiences with it. When we came in was that there was a startup.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And they had a product piece of software where it could be used using a Python client and they were going to be developing a Rest API so that clients their customers could use it in that way, so that meant they needed documentation for the rest API.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And they also weren&#8217;t happy with the contents that they had already, so they came across us. They did our quiz on What&#8217;s your developer portal KPI score? and emailed us to say<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">We&#8217;re not doing very well and can you help? And so we were engaged to r<\/span><span data-contrast=\"auto\">eorganise and restructure the content they already had.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Which lots of it was just moving stuff around into a more logical place and making the English a bit clearer and having content relating to this new API and how they could use it. So the stuff about getting started and troubleshooting and and all of that.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">They decided to use Redocly as the platform for the developer portal.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So that was going to be a docs section next to their websites and also to help them manage the process of creating the API in the OpenAPI definition file as well.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So that&#8217;s sort of the background of why w<\/span><span data-contrast=\"auto\">e we used it.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, perhaps you could outline for us what is Redoc and what is Redocly?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So, rather confusingly, if you&#8217;re not familiar with it, there&#8217;s one product called Redoc and one product called Redocly, and they&#8217;re both by the same company, but they do slightly different things.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Redoc is free, it&#8217;s open source, it&#8217;s it&#8217;s on GitHub and it&#8217;s been around for a while and you can use that if you&#8217;ve got an OpenAPI specification file or what&#8217;s known as the Swagger file. The thing that defines what bits of information they&#8217;re going to be shared via an API.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">You can take it that Swagger file OpenAPI reference file you&#8217;ve created, specification file you&#8217;ve created<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Run it through Redoc and what it will create is documentation API reference documentation so it&#8217;ll tell you the different methods and where they&#8217;re located and what the parameters are allowed. And so for generating b<\/span><span data-contrast=\"auto\">asic API reference documentation. You can use it and it&#8217;s a popular tool for that.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And so what they&#8217;ve done off the back of the popularity of that is add e<\/span><span data-contrast=\"auto\">xtra features and functionality to the reference documentation and the other stuff that you want when you&#8217;re creating the other documentatio a<\/span><span data-contrast=\"auto\">nd made a product which you can pay for called Redocly.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And there are<\/span><span data-contrast=\"auto\">\u00a0bits to Redocly around how API&#8217;s are created or the API lifecycle and older bigger companies rather than small ones.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So it&#8217;s not going to what those bits are. Does that make sense?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, I think so. If you could expand on that that would be great. Can you tell me a little bit about what sort of documentation can you provide if you use Redocly?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">I can do let me start a little bit before that, so there are one of the things that Redocly can do is help a company create this Swagger file with this API OpenAPI definition file. So most the stuff that we&#8217;ve dealt with on projects there&#8217;s been like one API d<\/span><span data-contrast=\"auto\">efinition file and we document that with larger companies and with more complex APIs.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Well then have that single file. They have multiple files that put together to make a definition file and what Redocly can do is help that complexity that&#8217;s involved with those more complex APIs. What happens in that situation is you have a master file or a main file.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So we don&#8217;t use master anymore. We use a main or root file and that sets the locations of where these subsidiary files are and.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So there&#8217;s a main structure, and then these ones, and then different people can work on these different areas. And in the case of this client though, we&#8217;re using a format for these subsidiary bits called gprc, which can make an API go faster.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Which we didn&#8217;t particularly get involved with, but but they do that and what can happen is, is that as you&#8217;re building these different bits and making up that specification file, what reductively can do is check that all these different bits when they&#8217;re put t<\/span><span data-contrast=\"auto\">ogether all are consistent and coherent and then validated because there&#8217;s a danger that one person will use one definition or one location, somebody else to use another, and then when you join them all together it falls over. So Redocly has got some tools for what it calls validating the files and then bundling them t<\/span><span data-contrast=\"auto\">ogether so they make this single file a<\/span><span data-contrast=\"auto\">nd to validate it, there&#8217;s what&#8217;s called linting, and that&#8217;s checking that the terminology and the links and all of that are consistent.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">They are correct, they follow a specific design standard or style so you can have like a single source of truth in order called dependencies or fit together more p<\/span><span data-contrast=\"auto\">ut towards that.<\/span><\/p>\n<p><span data-contrast=\"auto\"> Redoc also offers an extension if somebody is d<\/span><span data-contrast=\"auto\">eveloping in Visual Studio<\/span><span data-contrast=\"auto\"> it can do that. To developing your code in that developer environment, so we didn&#8217;t really get involved in that bit.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Apart from going i<\/span><span data-contrast=\"auto\">n and looking at some of the descriptions of these different methods.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And making sure they were clear and usual things, switching it from passive voice to active voice so it made it made it a little bit c<\/span><span data-contrast=\"auto\">learer, it does that, and then what? It can also do like the Redoc is automatically generate reference content.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">But what you&#8217;re giving? In addition, when you&#8217;re paying for Redocly over and above the free version is it will add in some extra bits, so we will add in a search.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">It will allow you to have a v<\/span><span data-contrast=\"auto\">ersion 1, version 2 and version 3 to switch between the different versions of the reference content.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">You can have it without the Redocly labelling and branding. It&#8217;ll be faster. You can change the look and feel.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And you can also have code samples that it&#8217;ll automatically generate, so when you have a reference point for creating something, it can create a code sample in.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Uhm, let&#8217;s pick a language in Python. It can create a code sample in Ruby and that will be there in the reference documentation automatically for you as well.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And it&#8217;s faster. The way in which it generates the API reference documentation is quicker and faster than the free version.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">What k<\/span><span data-contrast=\"auto\">ind of costs, are we looking at?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So those are two bits that we did and that was mainly done by the development team. There&#8217;s a third bit called in the actual creating of the developer portal itself, which is what we d<\/span><span data-contrast=\"auto\">id but to answer your question directly, there&#8217;s different versions of a free version for private use. A professional version, which is pretty much what most people go for.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And then there&#8217;s a a fully customizable enterprise version where it&#8217;s you know, calling for pricing or callers progressing. So the cost for the professional version is 300 a month.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">$300 a month, which is $3600 a year.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Which, if you&#8217;re a technical author, sounds e<\/span><span data-contrast=\"auto\">xpensive when people are struggling to try and get people to justify or get the budget to pay for an extra licence of Flare or RoboHelp.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">That does sound like an awful lot of m<\/span><span data-contrast=\"auto\">oney, but what you&#8217;re doing is you are using that to do this conversion process for the API.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And that&#8217;s generating that content for the people that are actually writing it all through the content. They&#8217;re doing that in a text editor.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">They&#8217;re doing markdown pages, so if you have one author or 10 authors, you don&#8217;t need another version of reductively you still ha<\/span><span data-contrast=\"auto\">ve that one version.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So if you think about the cost of <\/span><span data-contrast=\"auto\">Help authoring tools and the fact that they are by user and the more offers you have, the more expensive it gets, then it that pricing starts to make sense.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">There&#8217;s a third bit to Redocly, so if I go back to that so you can generate reference content, the documents you can use it to build your API specification file. If you&#8217;re a developer, what it can also do is that o<\/span><span data-contrast=\"auto\">ther stuff that you want on a portal.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So if you just have API reference content, it&#8217;s not great to use if you don&#8217;t understand what it is. If it&#8217;s a reference for create an index or create a vector and you don&#8217;t explain what an index or a vector are, then you&#8217;re going to get stuck very quickly in using the API. So particularly this client they they had stuff, but it didn&#8217;t.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">There wasn&#8217;t. They needed getting started. Information that was a lot clearer. They needed the concepts explained. It didn&#8217;t have a troubleshooting page. The process could be made clearer, so there&#8217;s a need to to add extra content to it.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So what you do is you write your content in markdown.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And you then p<\/span><span data-contrast=\"auto\">ush those files up to a GitHub repository and what Redocly does is it converts those markdown files into web pages as a documentation portal.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And what you can do in addition with Redocly to markdown pages is you can also c<\/span><span data-contrast=\"auto\">reate what are called MDX pages and then markdown pages where you can add some react JavaScript into it to make the page look a bit more jazzy.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">But what did you like about it? What was good about it for you during this project?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">It was interesting to use in we really were embedded in with the developers because the developers were writing the APIs in repositories on GitHub. The documentation was being written i<\/span><span data-contrast=\"auto\">n repositories and GitHub the process for approving the code was the same as the process for approving the documentation and the developer portal side of things.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">This was closely linked with the reference content that was being generated automatically. Now there is a feature that we talked to which we haven&#8217;t used or the client hasn&#8217;t implemented yet, which will be very interesting. One of those in the <\/span><span data-contrast=\"auto\">Getting started guide and explanations and the overviews were some code samples of how to do things over and above what was in the reference stuff.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">If something changed in the way they did the API, then we would have to go in and change the code samples or they&#8217;d have to tell us what the changes.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So the code samples were and go in and change that in the getting started guide or the overview because you can break down the API into these little files. 1 the capabilities that you&#8217;re m<\/span><span data-contrast=\"auto\">eant to do with Redocly is also b<\/span><span data-contrast=\"auto\">e able to embed.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Add those fragments of code into the user documentation as well, which means there&#8217;s the potential for the developers to change something in the API and automatically the code sample in the getting started guide changes also. So not only does the API reference bits automatically change t<\/span><span data-contrast=\"auto\">he code sample there so does in the reference side and that would save a lot of time and effort as it changes.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Sometimes the welcome portals can be a little bit dull because markdown is limited in what you can and can&#8217;t do with how it looks and the ability to do these index files just give more scope for that, although the So what you can get with result please. You can use a template.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Which is a developer portal they created with look and feel, and then it&#8217;s populated with a tutorial on how to use the application and basically what you do is you delete all the pages that they&#8217;ve created for how to use with locally and you replace them with the pages for your portal.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And it was a little bit tricky to make sense of how to u<\/span><span data-contrast=\"auto\">nderstand the react side of things, but if you are more familiar with the JavaScript elements than all of our Web developer background, I&#8217;m sure that would would be more beneficial.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So the template itself is relatively easy to customise. To change the photos and the headers.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Pretty easy, just to change the logo of the site. It took him just a few days. We were able to take the template and make it very much the clients look and feel with their fonts, their colours and all of that and that really helped because they could suddenly say yes. This is what it&#8217;s going to look like. You can also if you&#8217;ve got multiple <\/span><span data-contrast=\"auto\">API reference specification files. These Swagger files you can have a number of those in your portal, so if you&#8217;ve got an API catalogue with d<\/span><span data-contrast=\"auto\">ifferent API&#8217;s, it&#8217;s got the ability to manage that complexity as well.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And also the people that are writing the content and working for ridiculous as a number of them that are on the Write<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><span data-contrast=\"auto\">The Docs forum the Slack channel I posed a couple of questions on that and they messaged me and said if you&#8217;ve got any problems just l<\/span><span data-contrast=\"auto\">et me know.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So as an author, there is a sort o<\/span><span data-contrast=\"auto\">f a back c<\/span><span data-contrast=\"auto\">hannel. so now offers if there are any issues where they seem to be very willing to help and guide people to using the platform, and that&#8217;s that&#8217;s nice to see.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, that&#8217;s great. No, that&#8217;s really helpful.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Lot of positives. What about any caught any things that you didn&#8217;t particularly like? Things that not so great?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><\/p>\n<p><span data-contrast=\"auto\">So if you&#8217;re used to a background of a help authoring tool, when you create links and you move topics around all of the links go with you and there&#8217;s a style sheet and that can be very visual. So if you change the styles of things, you can see what the outcome.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">One is when you&#8217;re working with markdown, you&#8217;re using a text editor and or using a markdown editor, and you can get a sort of WYSIWYG thing where the headings are a bit bigger than the text.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">But the link tracking is more you typing in a hyperlink for where you want to go and if that file moves around, you&#8217;ve got to remember to update that change in the link and that becomes very time consuming. Particularly start changing file names so they&#8217;re all consistent or following conventions so.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">And there are t<\/span><span data-contrast=\"auto\">hese linters and they will go through and they will tell you if there&#8217;s broken links, but it&#8217;s.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">It&#8217;s a slightly different model to what you used to. It is a little bit frustrating in that it&#8217;s you&#8217;re not working in a content management system where it&#8217;s doing that in the background.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Yeah, the stylesheet that you get with reductively is what&#8217;s called a .TS file, and it&#8217;s got lots of styles all commented out, and then you could uncomment the ones that you want.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">It&#8217;s always in style sheets. If you look at somebody else&#8217;s stylesheet, it can be a real nightmare to try and work out what on earth is going on, and this was the case and we did some changes a<\/span><span data-contrast=\"auto\">nd got it to look OK. And then they were going to get their graphics designs to come in, and the graphics designer looked at the stylesheet and then said<\/span><span data-contrast=\"auto\"> this doesn&#8217;t make sense to me. And I think in the end one of the developers did some other minor tweaks to the Starship, and in some ways you could, I suppose s<\/span><span data-contrast=\"auto\">tart from a c<\/span><span data-contrast=\"auto\">ompletely your own stylesheet and go from that.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">What you get with ridiculous you can have navigation on the left to all the different pages and you can get on the right in Page navigation to all the headings in there.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">And if you don&#8217;t include a page in the file that contains all the things that are going to appear in the navigation, it will still appear, but it won&#8217;t have t<\/span><span data-contrast=\"auto\">he look and feel correct the way that the navigation.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">It&#8217;s done is it&#8217;s done by indenting a certain number of spaces, and then it can have higher revealed parent and child type links like you can get in other help files and the like.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">But we had a real struggle to get the OpenAPI specification file and the location of that to work and to get this nesting to <\/span><span data-contrast=\"auto\">work great.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Only getting in number of space indentations. It&#8217;s just tricky to do that.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So one of its quirks that going forward, you need be used to it. And no doubt, yeah, yeah.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><\/p>\n<p><span data-contrast=\"auto\">I mean, she&#8217;d get used to it, but coming from a traditional traditional.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Really cold.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, and you&#8217;re coming from a technically altering background using sort of technical authoring tools that seems a little different to what we would be used to.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, and things like conditional texts where you might want to mark things up and variables, so again you&#8217;ve got the capabilities of what you get with Markdown and GitHub markdown.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">There are some capabilities for including files like snippets and conditional text and like, but it gets more and more messy and complex.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Do those types of things.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Oh, the other aspects are that when you&#8217;re writing in markdown, you don&#8217;t have. As I said, you don&#8217;t have WYSIWYG.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So the way they get around that is, you install an application locally and in this case it&#8217;s a static site generator called Gatsby, and then when you make a change you go.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">You can look at the web page and it&#8217;s running a local server, so you go to localhost. I think it&#8217;s localhost:3000 and your p<\/span><span data-contrast=\"auto\">ages appear there and if you help you with how it looks then you can then take your changes. Use GitHub to make your local changes go up to the GitHub repository and then they&#8217;ll they can be approved and go on to the live site.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">So you&#8217;ve got a b<\/span><span data-contrast=\"auto\">it of setup that you need to do to install <\/span><span data-contrast=\"auto\">Gatsby, and to do that correctly.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">So it&#8217;s an interesting a<\/span><span data-contrast=\"auto\">pproach, be interesting to see if other clients.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">Let&#8217;s go with that.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">You get nice looking documentation. You get a search, it&#8217;s fast and you have this ability within the same tool to to do the portal stuff and the reference stuff and it can help the developers in building this API definition.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">It could grow in popularity and we mix it with others.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Yeah, thank you for that. Ellis, really interesting to hear your thoughts and your experiences on that particular project.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">I think I&#8217;d like to give it a go and see how I g<\/span><span data-contrast=\"auto\">et on, it&#8217;s just understanding some slightly different concepts to whatever more than in the past.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">But no, I think it sounds interesting, and I think you&#8217;ve given us a a great overview. I&#8217;d be really good to hear other peoples experiences as well. Thank you very much for tuning into the Cherryleaf podcast.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">How do they contact us?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">How do they contact us?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Info@cherryleaf.com<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">The What&#8217;s your developer portal to KPI score quiz that they did, that&#8217;s on the Cherryleaf website, and I think it&#8217;s on the homepage or on the API documentation page. People like taking it and just seeing how they score.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Gosh, what do they come up with?<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 1<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">On that, and then, if they want help, they can contact us so so like themselves up to them really.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\"> Speaker 3<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Absolutely everyone loves a quiz. All right? Well, thank you very much. I&#8217;m Ginny Critcher, and Ellis Pratt, both of us from Cherryleaf. Thanks for tuning in and look forward to next time.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Cherryleaf&#8217;s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation. More information: Redocly What is your developer portal\u2019s KPI score? Transcript Audio file\u00a0 redocly-final.mp3\u00a0 \u00a0 Transcript\u00a0 Speaker 2 This is the Cherryleaf podcast.\u00a0 Speaker 3\u00a0 Hi everybody, welcome to the Cherryleaf podcast. I&#8217;m Ginny Critcher and&#8230;  <a class=\"excerpt-read-more\" href=\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\" title=\"Read Podcast 118: What&#8217;s up Redocly?\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[662,197,1],"tags":[553,785,707,745,799],"class_list":["post-16136","post","type-post","status-publish","format-standard","hentry","category-api","category-podcast","category-uncategorized","tag-api","tag-developer-portals","tag-podcast","tag-project","tag-redocly"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Podcast 118: What&#039;s up Redocly? - Cherryleaf<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Podcast 118: What&#039;s up Redocly? - Cherryleaf\" \/>\n<meta property=\"og:description\" content=\"Cherryleaf&#8217;s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation. More information: Redocly What is your developer portal\u2019s KPI score? Transcript Audio file\u00a0 redocly-final.mp3\u00a0 \u00a0 Transcript\u00a0 Speaker 2 This is the Cherryleaf podcast.\u00a0 Speaker 3\u00a0 Hi everybody, welcome to the Cherryleaf podcast. I&#8217;m Ginny Critcher and... Read more &raquo;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\" \/>\n<meta property=\"og:site_name\" content=\"Cherryleaf\" \/>\n<meta property=\"article:published_time\" content=\"2021-11-12T10:16:19+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-11-12T10:17:24+00:00\" \/>\n<meta name=\"author\" content=\"ellis\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@cherryleafltd\" \/>\n<meta name=\"twitter:site\" content=\"@cherryleafltd\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"ellis\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"16 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\"},\"author\":{\"name\":\"ellis\",\"@id\":\"https:\/\/www.cherryleaf.com\/#\/schema\/person\/3aac161439df53b58fcbc8bcd6bf5318\"},\"headline\":\"Podcast 118: What&#8217;s up Redocly?\",\"datePublished\":\"2021-11-12T10:16:19+00:00\",\"dateModified\":\"2021-11-12T10:17:24+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\"},\"wordCount\":3704,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.cherryleaf.com\/#organization\"},\"keywords\":[\"api\",\"developer portals\",\"podcast\",\"project\",\"Redocly\"],\"articleSection\":[\"API\",\"podcast\",\"Uncategorized\"],\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\",\"url\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\",\"name\":\"Podcast 118: What's up Redocly? - Cherryleaf\",\"isPartOf\":{\"@id\":\"https:\/\/www.cherryleaf.com\/#website\"},\"datePublished\":\"2021-11-12T10:16:19+00:00\",\"dateModified\":\"2021-11-12T10:17:24+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.cherryleaf.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Podcast 118: What&#8217;s up Redocly?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.cherryleaf.com\/#website\",\"url\":\"https:\/\/www.cherryleaf.com\/\",\"name\":\"Cherryleaf\",\"description\":\"Clear instructions your users will love. Tel: +44 (0)207 100 4513\",\"publisher\":{\"@id\":\"https:\/\/www.cherryleaf.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.cherryleaf.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.cherryleaf.com\/#organization\",\"name\":\"Cherryleaf\",\"url\":\"https:\/\/www.cherryleaf.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/www.cherryleaf.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.cherryleaf.com\/wp-content\/uploads\/2018\/02\/cherryleaf-logo-snagit.png\",\"contentUrl\":\"https:\/\/www.cherryleaf.com\/wp-content\/uploads\/2018\/02\/cherryleaf-logo-snagit.png\",\"width\":435,\"height\":121,\"caption\":\"Cherryleaf\"},\"image\":{\"@id\":\"https:\/\/www.cherryleaf.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/x.com\/cherryleafltd\",\"https:\/\/www.youtube.com\/channel\/UCQQmJCmDrCqEAmBhinq0CIQ\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.cherryleaf.com\/#\/schema\/person\/3aac161439df53b58fcbc8bcd6bf5318\",\"name\":\"ellis\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/www.cherryleaf.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/9c3553ccbc10f078e4acf1f1f8f3b6df?s=96&r=pg\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/9c3553ccbc10f078e4acf1f1f8f3b6df?s=96&r=pg\",\"caption\":\"ellis\"},\"sameAs\":[\"https:\/\/www.cherryleaf.com\"],\"url\":\"https:\/\/www.cherryleaf.com\/author\/ellis\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Podcast 118: What's up Redocly? - Cherryleaf","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/","og_locale":"en_GB","og_type":"article","og_title":"Podcast 118: What's up Redocly? - Cherryleaf","og_description":"Cherryleaf&#8217;s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation. More information: Redocly What is your developer portal\u2019s KPI score? Transcript Audio file\u00a0 redocly-final.mp3\u00a0 \u00a0 Transcript\u00a0 Speaker 2 This is the Cherryleaf podcast.\u00a0 Speaker 3\u00a0 Hi everybody, welcome to the Cherryleaf podcast. I&#8217;m Ginny Critcher and... Read more &raquo;","og_url":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/","og_site_name":"Cherryleaf","article_published_time":"2021-11-12T10:16:19+00:00","article_modified_time":"2021-11-12T10:17:24+00:00","author":"ellis","twitter_card":"summary_large_image","twitter_creator":"@cherryleafltd","twitter_site":"@cherryleafltd","twitter_misc":{"Written by":"ellis","Estimated reading time":"16 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#article","isPartOf":{"@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/"},"author":{"name":"ellis","@id":"https:\/\/www.cherryleaf.com\/#\/schema\/person\/3aac161439df53b58fcbc8bcd6bf5318"},"headline":"Podcast 118: What&#8217;s up Redocly?","datePublished":"2021-11-12T10:16:19+00:00","dateModified":"2021-11-12T10:17:24+00:00","mainEntityOfPage":{"@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/"},"wordCount":3704,"commentCount":0,"publisher":{"@id":"https:\/\/www.cherryleaf.com\/#organization"},"keywords":["api","developer portals","podcast","project","Redocly"],"articleSection":["API","podcast","Uncategorized"],"inLanguage":"en-GB","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/","url":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/","name":"Podcast 118: What's up Redocly? - Cherryleaf","isPartOf":{"@id":"https:\/\/www.cherryleaf.com\/#website"},"datePublished":"2021-11-12T10:16:19+00:00","dateModified":"2021-11-12T10:17:24+00:00","breadcrumb":{"@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.cherryleaf.com\/"},{"@type":"ListItem","position":2,"name":"Podcast 118: What&#8217;s up Redocly?"}]},{"@type":"WebSite","@id":"https:\/\/www.cherryleaf.com\/#website","url":"https:\/\/www.cherryleaf.com\/","name":"Cherryleaf","description":"Clear instructions your users will love. Tel: +44 (0)207 100 4513","publisher":{"@id":"https:\/\/www.cherryleaf.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.cherryleaf.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/www.cherryleaf.com\/#organization","name":"Cherryleaf","url":"https:\/\/www.cherryleaf.com\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.cherryleaf.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.cherryleaf.com\/wp-content\/uploads\/2018\/02\/cherryleaf-logo-snagit.png","contentUrl":"https:\/\/www.cherryleaf.com\/wp-content\/uploads\/2018\/02\/cherryleaf-logo-snagit.png","width":435,"height":121,"caption":"Cherryleaf"},"image":{"@id":"https:\/\/www.cherryleaf.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/cherryleafltd","https:\/\/www.youtube.com\/channel\/UCQQmJCmDrCqEAmBhinq0CIQ"]},{"@type":"Person","@id":"https:\/\/www.cherryleaf.com\/#\/schema\/person\/3aac161439df53b58fcbc8bcd6bf5318","name":"ellis","image":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.cherryleaf.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/9c3553ccbc10f078e4acf1f1f8f3b6df?s=96&r=pg","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/9c3553ccbc10f078e4acf1f1f8f3b6df?s=96&r=pg","caption":"ellis"},"sameAs":["https:\/\/www.cherryleaf.com"],"url":"https:\/\/www.cherryleaf.com\/author\/ellis\/"}]}},"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/posts\/16136"}],"collection":[{"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/comments?post=16136"}],"version-history":[{"count":0,"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/posts\/16136\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/media?parent=16136"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/categories?post=16136"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cherryleaf.com\/wp-json\/wp\/v2\/tags?post=16136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}