Notice: Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the health-check domain was triggered too early. This is usually an indicator for some code in the plugin or theme running too early. Translations should be loaded at the init action or later. Please see Debugging in WordPress for more information. (This message was added in version 6.7.0.) in /home/sites/cherryleaf.com/public_html/wp-includes/functions.php on line 6114

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893

Warning: Cannot modify header information - headers already sent by (output started at /home/sites/cherryleaf.com/public_html/wp-includes/functions.php:6114) in /home/sites/cherryleaf.com/public_html/wp-includes/rest-api/class-wp-rest-server.php on line 1893
{"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’s up Redocly?"},"content":{"rendered":"

Cherryleaf’s Ginny Critcher and Ellis Pratt discuss using the Redocly platform to create a developer portal and API documentation.<\/p>\n

More information:<\/p>\n

What is your developer portal\u2019s KPI score?<\/a><\/p>\n

<\/iframe><\/p>\nTranscript<\/p>\nAudio file<\/span>\u00a0<\/span><\/p>\n<a href=\"https:\/\/cherryleaf-my.sharepoint.com\/personal\/ellis_cherryleaf_com\/Documents\/Transcribed%20Files\/redocly-final.mp3\">redocly-final.mp3<\/span><\/a>\u00a0<\/span><\/p>\n\u00a0<\/span><\/p>\nTranscript<\/span>\u00a0<\/span><\/p>\n Speaker 2<\/span><\/p>\nThis is the Cherryleaf podcast.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nHi everybody, welcome to the Cherryleaf podcast. I’m Ginny Critcher and I will be talking to Ellis Pratt today. He’s going to talk a little bit about our experience using Redocly on a recent project.<\/span>\u00a0<\/span><\/p>\nOh maybe y<\/span>ou’d like to start off by giving us the background.<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nYeah, 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>\nAnd Redocly is a fairly new p<\/span>latform, the developer portal bit of it is still in officially in beta.<\/span>\u00a0<\/span><\/p>\nIt’s getting more attention in recent times. It’s the first time we’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>\u00a0<\/span><\/p>\nAnd 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>\u00a0<\/span><\/p>\nAnd they also weren’t happy with the contents that they had already, so they came across us. They did our quiz on What’s your developer portal KPI score? and emailed us to say<\/span>\u00a0<\/span><\/p>\nWe’re not doing very well and can you help? And so we were engaged to r<\/span>eorganise and restructure the content they already had.<\/span>\u00a0<\/span><\/p>\nWhich 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>\u00a0<\/span><\/p>\nThey decided to use Redocly as the platform for the developer portal.<\/span>\u00a0<\/span><\/p>\nSo 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>\u00a0<\/span><\/p>\nSo that’s sort of the background of why w<\/span>e we used it.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nYeah, perhaps you could outline for us what is Redoc and what is Redocly?<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nSo, rather confusingly, if you’re not familiar with it, there’s one product called Redoc and one product called Redocly, and they’re both by the same company, but they do slightly different things.<\/span>\u00a0<\/span><\/p>\n <\/p>\nRedoc is free, it’s open source, it’s it’s on GitHub and it’s been around for a while and you can use that if you’ve got an OpenAPI specification file or what’s known as the Swagger file. The thing that defines what bits of information they’re going to be shared via an API.<\/span>\u00a0<\/span><\/p>\n <\/p>\nYou can take it that Swagger file OpenAPI reference file you’ve created, specification file you’ve created<\/span>\u00a0<\/span><\/p>\n <\/p>\nRun it through Redoc and what it will create is documentation API reference documentation so it’ll tell you the different methods and where they’re located and what the parameters are allowed. And so for generating b<\/span>asic API reference documentation. You can use it and it’s a popular tool for that.<\/span>\u00a0<\/span><\/p>\nAnd so what they’ve done off the back of the popularity of that is add e<\/span>xtra features and functionality to the reference documentation and the other stuff that you want when you’re creating the other documentatio a<\/span>nd made a product which you can pay for called Redocly.<\/span>\u00a0<\/span><\/p>\n <\/p>\nAnd there are<\/span>\u00a0bits to Redocly around how API’s are created or the API lifecycle and older bigger companies rather than small ones.<\/span>\u00a0<\/span><\/p>\nSo it’s not going to what those bits are. Does that make sense?<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nYeah, 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>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nI 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’ve dealt with on projects there’s been like one API d<\/span>efinition file and we document that with larger companies and with more complex APIs.<\/span>\u00a0<\/span><\/p>\nWell 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’s involved with those more complex APIs. What happens in that situation is you have a master file or a main file.<\/span>\u00a0<\/span><\/p>\nSo we don’t use master anymore. We use a main or root file and that sets the locations of where these subsidiary files are and.<\/span>\u00a0<\/span><\/p>\nSo there’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’re using a format for these subsidiary bits called gprc, which can make an API go faster.<\/span>\u00a0<\/span><\/p>\nWhich we didn’t particularly get involved with, but but they do that and what can happen is, is that as you’re building these different bits and making up that specification file, what reductively can do is check that all these different bits when they’re put t<\/span>ogether all are consistent and coherent and then validated because there’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>ogether so they make this single file a<\/span>nd to validate it, there’s what’s called linting, and that’s checking that the terminology and the links and all of that are consistent.<\/span>\u00a0<\/span><\/p>\nThey 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>ut towards that.<\/span><\/p>\n Redoc also offers an extension if somebody is d<\/span>eveloping in Visual Studio<\/span> it can do that. To developing your code in that developer environment, so we didn’t really get involved in that bit.<\/span>\u00a0<\/span><\/p>\n <\/p>\nApart from going i<\/span>n and looking at some of the descriptions of these different methods.<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\nAnd 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>learer, it does that, and then what? It can also do like the Redoc is automatically generate reference content.<\/span>\u00a0<\/span><\/p>\n <\/p>\nBut what you’re giving? In addition, when you’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>\u00a0<\/span><\/p>\n <\/p>\nIt will allow you to have a v<\/span>ersion 1, version 2 and version 3 to switch between the different versions of the reference content.<\/span>\u00a0<\/span><\/p>\n <\/p>\nYou can have it without the Redocly labelling and branding. It’ll be faster. You can change the look and feel.<\/span>\u00a0<\/span><\/p>\n <\/p>\nAnd you can also have code samples that it’ll automatically generate, so when you have a reference point for creating something, it can create a code sample in.<\/span>\u00a0<\/span><\/p>\n <\/p>\nUhm, let’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>\u00a0<\/span><\/p>\n <\/p>\nAnd it’s faster. The way in which it generates the API reference documentation is quicker and faster than the free version.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nWhat k<\/span>ind of costs, are we looking at?<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nSo those are two bits that we did and that was mainly done by the development team. There’s a third bit called in the actual creating of the developer portal itself, which is what we d<\/span>id but to answer your question directly, there’s different versions of a free version for private use. A professional version, which is pretty much what most people go for.<\/span>\u00a0<\/span><\/p>\nAnd then there’s a a fully customizable enterprise version where it’s you know, calling for pricing or callers progressing. So the cost for the professional version is 300 a month.<\/span>\u00a0<\/span><\/p>\n$300 a month, which is $3600 a year.<\/span>\u00a0<\/span><\/p>\nWhich, if you’re a technical author, sounds e<\/span>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>\u00a0<\/span><\/p>\n <\/p>\nThat does sound like an awful lot of m<\/span>oney, but what you’re doing is you are using that to do this conversion process for the API.<\/span>\u00a0<\/span><\/p>\n <\/p>\nAnd that’s generating that content for the people that are actually writing it all through the content. They’re doing that in a text editor.<\/span>\u00a0<\/span><\/p>\n <\/p>\nThey’re doing markdown pages, so if you have one author or 10 authors, you don’t need another version of reductively you still ha<\/span>ve that one version.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo if you think about the cost of <\/span>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>\u00a0<\/span><\/p>\n <\/p>\nThere’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’re a developer, what it can also do is that o<\/span>ther stuff that you want on a portal.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo if you just have API reference content, it’s not great to use if you don’t understand what it is. If it’s a reference for create an index or create a vector and you don’t explain what an index or a vector are, then you’re going to get stuck very quickly in using the API. So particularly this client they they had stuff, but it didn’t.<\/span>\u00a0<\/span><\/p>\n <\/p>\nThere wasn’t. They needed getting started. Information that was a lot clearer. They needed the concepts explained. It didn’t have a troubleshooting page. The process could be made clearer, so there’s a need to to add extra content to it.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo what you do is you write your content in markdown.<\/span>\u00a0<\/span><\/p>\nAnd you then p<\/span>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>\u00a0<\/span><\/p>\n <\/p>\nAnd what you can do in addition with Redocly to markdown pages is you can also c<\/span>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>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nBut what did you like about it? What was good about it for you during this project?<\/span>\u00a0<\/span><\/p>\n <\/p>\nIt 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>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>\u00a0<\/span><\/p>\n <\/p>\nThis was closely linked with the reference content that was being generated automatically. Now there is a feature that we talked to which we haven’t used or the client hasn’t implemented yet, which will be very interesting. One of those in the <\/span>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>\u00a0<\/span><\/p>\n <\/p>\nIf something changed in the way they did the API, then we would have to go in and change the code samples or they’d have to tell us what the changes.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo 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’re m<\/span>eant to do with Redocly is also b<\/span>e able to embed.<\/span>\u00a0<\/span><\/p>\n <\/p>\nAdd those fragments of code into the user documentation as well, which means there’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>he code sample there so does in the reference side and that would save a lot of time and effort as it changes.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSometimes the welcome portals can be a little bit dull because markdown is limited in what you can and can’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>\u00a0<\/span><\/p>\n <\/p>\nWhich is a developer portal they created with look and feel, and then it’s populated with a tutorial on how to use the application and basically what you do is you delete all the pages that they’ve created for how to use with locally and you replace them with the pages for your portal.<\/span>\u00a0<\/span><\/p>\nAnd it was a little bit tricky to make sense of how to u<\/span>nderstand the react side of things, but if you are more familiar with the JavaScript elements than all of our Web developer background, I’m sure that would would be more beneficial.<\/span>\u00a0<\/span><\/p>\nSo the template itself is relatively easy to customise. To change the photos and the headers.<\/span>\u00a0<\/span><\/p>\nPretty 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’s going to look like. You can also if you’ve got multiple <\/span>API reference specification files. These Swagger files you can have a number of those in your portal, so if you’ve got an API catalogue with d<\/span>ifferent API’s, it’s got the ability to manage that complexity as well.<\/span>\u00a0<\/span><\/p>\nAnd also the people that are writing the content and working for ridiculous as a number of them that are on the Write<\/span>\u00a0<\/span>The Docs forum the Slack channel I posed a couple of questions on that and they messaged me and said if you’ve got any problems just l<\/span>et me know.<\/span>\u00a0<\/span><\/p>\nSo as an author, there is a sort o<\/span>f a back c<\/span>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’s that’s nice to see.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nYeah, that’s great. No, that’s really helpful.<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nYeah<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nLot of positives. What about any caught any things that you didn’t particularly like? Things that not so great?<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span><\/p>\nSo if you’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’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>\u00a0<\/span><\/p>\n <\/p>\nOne is when you’re working with markdown, you’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>\u00a0<\/span><\/p>\n <\/p>\nBut the link tracking is more you typing in a hyperlink for where you want to go and if that file moves around, you’ve got to remember to update that change in the link and that becomes very time consuming. Particularly start changing file names so they’re all consistent or following conventions so.<\/span>\u00a0<\/span><\/p>\n <\/p>\nAnd there are t<\/span>hese linters and they will go through and they will tell you if there’s broken links, but it’s.<\/span>\u00a0<\/span><\/p>\n <\/p>\nIt’s a slightly different model to what you used to. It is a little bit frustrating in that it’s you’re not working in a content management system where it’s doing that in the background.<\/span>\u00a0<\/span><\/p>\n <\/p>\nYeah, the stylesheet that you get with reductively is what’s called a .TS file, and it’s got lots of styles all commented out, and then you could uncomment the ones that you want.<\/span>\u00a0<\/span><\/p>\nIt’s always in style sheets. If you look at somebody else’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>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> this doesn’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>tart from a c<\/span>ompletely your own stylesheet and go from that.<\/span>\u00a0<\/span><\/p>\n <\/p>\nWhat 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>\u00a0<\/span><\/p>\nAnd if you don’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’t have t<\/span>he look and feel correct the way that the navigation.<\/span>\u00a0<\/span><\/p>\n <\/p>\nIt’s done is it’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>\u00a0<\/span><\/p>\n <\/p>\nBut 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>work great.<\/span>\u00a0<\/span><\/p>\nOnly getting in number of space indentations. It’s just tricky to do that.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nSo one of its quirks that going forward, you need be used to it. And no doubt, yeah, yeah.<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span><\/p>\nI mean, she’d get used to it, but coming from a traditional traditional.<\/span>\u00a0<\/span><\/p>\nReally cold.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nYeah, and you’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>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nYeah, and things like conditional texts where you might want to mark things up and variables, so again you’ve got the capabilities of what you get with Markdown and GitHub markdown.<\/span>\u00a0<\/span><\/p>\nThere are some capabilities for including files like snippets and conditional text and like, but it gets more and more messy and complex.<\/span>\u00a0<\/span><\/p>\nDo those types of things.<\/span>\u00a0<\/span><\/p>\n <\/p>\nOh, the other aspects are that when you’re writing in markdown, you don’t have. As I said, you don’t have WYSIWYG.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo the way they get around that is, you install an application locally and in this case it’s a static site generator called Gatsby, and then when you make a change you go.<\/span>\u00a0<\/span><\/p>\n <\/p>\nYou can look at the web page and it’s running a local server, so you go to localhost. I think it’s localhost:3000 and your p<\/span>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’ll they can be approved and go on to the live site.<\/span>\u00a0<\/span><\/p>\n <\/p>\nSo you’ve got a b<\/span>it of setup that you need to do to install <\/span>Gatsby, and to do that correctly.<\/span>\u00a0<\/span><\/p>\nSo it’s an interesting a<\/span>pproach, be interesting to see if other clients.<\/span>\u00a0<\/span><\/p>\n <\/p>\nLet’s go with that.<\/span>\u00a0<\/span><\/p>\n <\/p>\nYou get nice looking documentation. You get a search, it’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>\u00a0<\/span><\/p>\n <\/p>\nIt could grow in popularity and we mix it with others.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nYeah, thank you for that. Ellis, really interesting to hear your thoughts and your experiences on that particular project.<\/span>\u00a0<\/span><\/p>\n <\/p>\nI think I’d like to give it a go and see how I g<\/span>et on, it’s just understanding some slightly different concepts to whatever more than in the past.<\/span>\u00a0<\/span><\/p>\n <\/p>\nBut no, I think it sounds interesting, and I think you’ve given us a a great overview. I’d be really good to hear other peoples experiences as well. Thank you very much for tuning into the Cherryleaf podcast.<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nHow do they contact us?<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nHow do they contact us?<\/span>\u00a0<\/span><\/p>\nInfo@cherryleaf.com<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nThe What’s your developer portal to KPI score quiz that they did, that’s on the Cherryleaf website, and I think it’s on the homepage or on the API documentation page. People like taking it and just seeing how they score.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nGosh, what do they come up with?<\/span>\u00a0<\/span><\/p>\n Speaker 1<\/span>\u00a0<\/span><\/p>\nOn that, and then, if they want help, they can contact us so so like themselves up to them really.<\/span>\u00a0<\/span><\/p>\n Speaker 3<\/span>\u00a0<\/span><\/p>\nAbsolutely everyone loves a quiz. All right? Well, thank you very much. I’m Ginny Critcher, and Ellis Pratt, both of us from Cherryleaf. Thanks for tuning in and look forward to next time.<\/span>\u00a0<\/span><\/p>\n\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"Cherryleaf’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’m Ginny Critcher and… <a class=\"excerpt-read-more\" href=\"https:\/\/www.cherryleaf.com\/2021\/11\/podcast-118-whats-up-redocly\/\" title=\"Read Podcast 118: What’s up Redocly?\">Read more »<\/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":"\n<title>Podcast 118: What'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's up Redocly? - Cherryleaf\" \/>\n<meta property=\"og:description\" content=\"Cherryleaf’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’m Ginny Critcher and... Read more »\" \/>\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’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’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_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’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’m Ginny Critcher and... Read more »","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’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’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","targetHints":{"allow":["GET"]}}],"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}]}}