{"posts":[{"template":"../@theme/templates/BlogPost","title":"Catch API drift with the new proxy and drift commands","description":"Record real HTTP traffic with the proxy command, then let the drift command tell you where your API and your OpenAPI description disagree.","seo":{"title":"Catch API drift with the new proxy and drift commands","description":"Record real HTTP traffic with the proxy command, then let the drift command tell you where your API and your OpenAPI description disagree."},"author":{"id":"adam-sobaniec","name":"Adam Sobaniec","authorBIO":"Software Engineer, Redocly","image":"/assets/sobaniec.d72cecde632c015ce4db05cc559e1f27ccae55d6e5977f816362afb23a1a56a7.978384e4.png"},"publishedDate":"2026-07-21","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}},{"category":{"id":"api-testing","label":"API testing"},"subcategory":{"id":"integration-testing","label":"Integration testing"}}],"slug":"/blog/catch-api-drift"},{"template":"../@theme/templates/BlogPost","title":"Introducing the Replay tab in Reunite","description":"Test your API functions live, right inside the Reunite editor. No more copying tokens into an API client or dropping to a terminal to check one endpoint.","seo":{"title":"Introducing the Replay tab in Reunite","description":"Test your API functions live, right inside the Reunite editor. No more copying tokens into an API client or dropping to a terminal to check one endpoint.","image":"./images/replay-tab-reunite.png"},"author":{"id":"vitalii-skulskyi","name":"Vitalii Skulskyi","authorBIO":"Software Engineer, Redocly","image":"/assets/skulskyi.b89317ad3d6a2c624b76e305e4f943045c58f1b079e643664255a4df13fca14c.978384e4.jpg"},"publishedDate":"2026-07-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"reunite","label":"Reunite"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"slug":"/blog/replay-tab-reunite"},{"template":"../@theme/templates/BlogPost","title":"Arazzo 1.1 Release","description":"Arazzo 1.1 adds AsyncAPI support, workflow composition, selectors, identity-based references, and clearer runtime behavior.","seo":{"title":"Arazzo Specification 1.1 Release","description":"Arazzo 1.1 adds AsyncAPI support, workflow composition, selectors, identity-based references, and clearer runtime behavior."},"author":{"id":"dmytro-ananskyi","name":"Dmytro Ananskyi","authorBIO":"Software Engineer, Redocly","image":"/assets/ananskyi.acf1af1087a6b33730c15c9192144ed8c796e325d2366138e953f3c71255ce9f.978384e4.png"},"publishedDate":"2026-05-20","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"arazzo","label":"Arazzo"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"slug":"/blog/arazzo-specification-1-1-release"},{"template":"../@theme/templates/BlogPost","title":"What you really need to build an API sandbox","description":"Integration is the most dangerous phase of the API lifecycle. Learn the infrastructure requirements for building a true API sandbox that validates stateful business logic, not just HTTP contracts.","seo":{"title":"What you really need to build an API sandbox | Redocly","description":"Discover the critical requirements for building API sandboxes that support complex workflows, from environmental isolation to webhook simulation and deterministic testing."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-04-24T00:00:00.000Z","categories":[{"category":{"id":"api-testing","label":"API testing"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"}},{"category":{"id":"developer-portal","label":"Developer portal"}}],"slug":"/blog/api-sandbox-requirements"},{"template":"../@theme/templates/BlogPost","title":"Why API catalogs are critical for agentic software development","description":"The primary bottleneck for AI agents in software development is no longer model reasoning capability—it's the ability to validly discover and safely invoke the right tools.","seo":{"title":"Why API catalogs are critical for agentic software development | Redocly","description":"Learn how API catalogs transform from static documentation into active systems of record for AI agents, enabling safe discovery and execution of tools in software development workflows."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-04-23T00:00:00.000Z","categories":[{"category":{"id":"api-catalog","label":"API catalog"}},{"category":{"id":"internal-developer-portal","label":"Internal developer portal"}},{"category":{"id":"api-governance","label":"API governance"}}],"slug":"/blog/api-catalogs-agentic-software"},{"template":"../@theme/templates/BlogPost","title":"API contract testing from OpenAPI using Arazzo","description":"Your OpenAPI spec is a contract. Learn how to enforce it automatically with API contract testing using the Arazzo standard and Redocly's Respect CLI.","seo":{"title":"API contract testing from OpenAPI using Arazzo","description":"Your OpenAPI spec is a contract. Learn how to enforce it automatically with API contract testing using the Arazzo standard and Redocly's Respect CLI.","image":"./images/api-contract-testing-arazzo.png"},"author":{"id":"roman-marshevskyi","name":"Roman Marshevskyi","authorBIO":"Director of Engineering, Redocly","image":"/assets/marshevskyi.642f924e188912716ccc91863cae9d6a4979994d1c5341d88c0bddaeffef614b.978384e4.png"},"publishedDate":"2026-04-22","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"compliance-quality","label":"Compliance & quality"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/api-contract-testing-arazzo.edf0e7fb5145914f9b6ff425b13b55e0257b4cdf311737b2f65e9c71b98d054e.978384e4.png","slug":"/blog/api-contract-testing-arazzo"},{"template":"../@theme/templates/BlogPost","title":"Enforcing API security policies","description":"Securing an API ecosystem requires more than just placing a gateway in front of your services. Effective API security policies must operate as a continuous contract, codified during design and enforced through deployment and runtime access.","seo":{"title":"Enforcing API security policies | Redocly","description":"Learn how to implement API security policies across design-time and runtime enforcement, covering authentication, authorization, traffic management, and data governance."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-04-16T00:00:00.000Z","categories":[{"category":{"id":"api-governance","label":"API governance"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"}},{"category":{"id":"api-specifications","label":"API specifications"}}],"slug":"/blog/enforcing-api-security-policies"},{"template":"../@theme/templates/BlogPost","title":"OpenAPI 3.2 is here: what's new and how Redocly supports it","description":"An overview of OpenAPI 3.2 features and how to start using them with Redocly.","seo":{"title":"OpenAPI 3.2 is here: what's new and how Redocly supports it","description":"An overview of OpenAPI 3.2 features and how to start using them with Redocly."},"author":{"id":"ivan-kropyvnytskyi","name":"Ivan Kropyvnytskyi","authorBIO":"Software Engineer, Redocly","image":"/assets/ivan.3cc67081b64732af52d567c6f8246b08d857c7300cf982fd46ea6d9f128958b3.978384e4.png"},"publishedDate":"2026-03-11","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/redocly_blog_6.3d6a98ac902e018a33e5a53ef47a306e043108c9bf9efd992324b75c2c80ebdc.978384e4.jpg","slug":"/blog/openapi-3-2"},{"template":"../@theme/templates/BlogPost","title":"SEO best practices for documentation","description":"Learn technical SEO best practices specifically for documentation. Master canonicals, versioning strategy, and crawlability to improve discoverability.","seo":{"title":"SEO best practices for documentation | Redocly","description":"Master technical SEO for documentation sites: canonicals, versioning strategy, crawlability, Core Web Vitals, and information architecture patterns.","image":"./images/seo-best-practices.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-03-05T00:00:00.000Z","categories":[{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"api-seo","label":"API SEO"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"information-architecture-td","label":"Information architecture"}},{"category":{"id":"developer-portal","label":"Developer portal"},"subcategory":{"id":"information-architecture","label":"Information architecture"}}],"image":"/assets/seo-best-practices.f916306b5931baacd4ce2450d35bd7d79cc2c2ebf35d0ef82288a37df1bc08be.978384e4.png","slug":"/blog/seo-best-practices-documentation"},{"template":"../@theme/templates/BlogPost","title":"Update on Redocly Workflows migration timeline","description":"We are extending the Workflows migration timeline to support customers who need additional time. Workflows will continue to be supported while customers complete their migration plans.","seo":{"title":"Update on Redocly Workflows migration timeline | Redocly","description":"We are extending the Workflows migration timeline. Workflows will continue to be supported while customers complete their migration plans.","image":"./images/workflows-migration-timeline.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-02-26T00:00:00.000Z","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/workflows-migration-timeline.b34caff5b74fc1e753d40f3d5c2c75b5e009b65acc5d770ebbb0307b36687433.978384e4.png","slug":"/blog/workflows-migration-timeline-update"},{"template":"../@theme/templates/BlogPost","title":"Three Root Causes: Why we lose to the invisible man","description":"After identifying unforced errors in API design, I found three root causes on the tennis court that map directly to how we build APIs. Here's what they are and how to fix them.","seo":{"title":"Three Root Causes: Why we lose to the invisible man | Redocly","description":"Discover the three root causes behind unforced errors in API design: poor balance, feeling rushed, and looking too far ahead, and how to address them.","image":"./images/invisible-man.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-02-05T00:00:00.000Z","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"writing-style","label":"Writing style"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"compliance-quality","label":"Compliance & quality"}}],"image":"/assets/invisible-man.9a2d5b90f1be154d8506d646c844c2605d656088ced7d7283da9310ff59472d6.978384e4.png","slug":"/blog/three-root-causes-invisible-man"},{"template":"../@theme/templates/BlogPost","title":"Beat the Invisible Man: Unforced errors in API design","description":"Most APIs don't fail because competitors outplayed them. They fail because of unforced errors—small mistakes that shouldn't exist. Here's how to identify and eliminate them.","seo":{"title":"Beat the Invisible Man: Unforced errors in API design | Redocly","description":"Learn how to identify and eliminate unforced errors in API design and documentation that cause silent failures and developer frustration.","image":"./images/invisible-man.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-01-29T00:00:00.000Z","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"writing-style","label":"Writing style"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"compliance-quality","label":"Compliance & quality"}}],"image":"/assets/invisible-man.9a2d5b90f1be154d8506d646c844c2605d656088ced7d7283da9310ff59472d6.978384e4.png","slug":"/blog/beat-the-invisible-man"},{"template":"../@theme/templates/BlogPost","title":"Incident postmortem: January 2026 service disruptions","description":"Detailed analysis of service disruptions in January 2026, explaining root causes and corrective measures implemented to prevent future incidents.","seo":{"title":"Incident postmortem: January 2026 service disruptions","description":"Detailed analysis of service disruptions in January 2026, explaining root causes and corrective measures implemented to prevent future incidents.","image":"./images/postmortem-jan-2026.png"},"author":{"id":"roman-hotsiy","name":"Roman Hotsiy","authorBIO":"CTO and Founder, Redocly","image":"/assets/roman.f8898bfe764099b1e94326b0f69dc6af33d948811a4416ba66dae591385c27c7.978384e4.png"},"publishedDate":"2026-01-27T00:00:00.000Z","categories":[{"category":{"id":"redocly","label":"Redocly"}}],"image":"/assets/postmortem-jan-2026.86ce6a84683a42aac1fb2c719e20f5ea179cf8fe4340c22fa18e177be41b7e82.978384e4.png","slug":"/blog/jan-2026-outage-postmortem"},{"template":"../@theme/templates/BlogPost","title":"The sandbox reality check","description":"Organizations want org-level sandbox environments for thousands of APIs. Here are the proven patterns that work at scale—and why they require platform building blocks, not just automation.","seo":{"title":"Sandbox environments reality check | Redocly","description":"Learn about proven org-level sandbox patterns that work at scale, what makes a real sandbox different from mock servers, and why platform building blocks matter more than automation.","image":"./images/sandbox-env.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2026-01-13T00:00:00.000Z","categories":[{"category":{"id":"api-testing","label":"API testing"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"}},{"category":{"id":"developer-portal","label":"Developer portal"}}],"image":"/assets/sandbox-env.9bf1868d9cbee772e67fdfb8ccc0f50f701fc6dbb0d24d0e31add39a9e915be5.978384e4.png","slug":"/blog/sandbox-environments-reality-check"},{"template":"../@theme/templates/BlogPost","title":"API catalog is the AI substrate of the future","description":"As AI agents join human developers, enterprise alignment becomes critical. API catalogs aren't just organization tools—they're the substrate that makes AI-human collaboration possible at scale.","seo":{"title":"API catalog as the AI substrate of the future | Redocly","description":"Discover how API catalogs become essential infrastructure when AI agents work alongside developers. Learn why catalogs must extend beyond APIs to include services, people, and AI agents.","image":"./images/catalog-ai-substrate.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-12-18T00:00:00.000Z","categories":[{"category":{"id":"api-catalog","label":"API catalog"}}],"image":"/assets/catalog-ai-substrate.66fc1bcd890612494c72be05f3808118450131d8da675cbea386f9d3c3e5e52d.978384e4.png","slug":"/blog/api-catalog-ai-substrate"},{"template":"../@theme/templates/BlogPost","title":"The three characters in every enterprise API ecosystem","description":"Why some teams multiply value, some amplify it, and some quietly create drag. Understanding these behavioral archetypes changes how you think about API strategy.","seo":{"title":"The three characters in every enterprise API ecosystem | Redocly","description":"Discover the three behavioral archetypes in enterprise API ecosystems—the Benefactor, the Amplifier, and the Redundancer—and how they impact cost, velocity, and architectural health.","image":"./images/api-ecosystem-characters.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-12-17T00:00:00.000Z","categories":[{"category":{"id":"api-catalog","label":"API catalog"}}],"image":"/assets/api-ecosystem-characters.5002528963bc4f581d5eddee5f20568997d54f3f781832f10e2960f5c08dd565.978384e4.png","slug":"/blog/api-ecosystem-characters"},{"template":"../@theme/templates/BlogPost","title":"The hidden costs of an enterprise API","description":"Building and maintaining an enterprise-grade microservice API costs far more than hosting. Here's the real math—and how API catalogs drive reuse that saves millions.","seo":{"title":"The hidden costs of an enterprise API | Redocly","description":"Discover the true cost of building and maintaining enterprise APIs—from compliance to security testing to documentation. Learn how API catalogs drive reuse and save millions.","image":"./images/hidden-cost-of-an-enterprise-api.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-12-11T00:00:00.000Z","categories":[{"category":{"id":"api-catalog","label":"API catalog"}}],"image":"/assets/hidden-cost-of-an-enterprise-api.a71c7ba95c0001dd8934549bcea9aa3c9ebfff52879ba34fb0b0995eb8c8a2de.978384e4.png","slug":"/blog/hidden-cost-of-an-enterprise-api"},{"template":"../@theme/templates/BlogPost","title":"Reorganizing our blog for better discovery and SEO","description":"How we restructured our blog with hierarchical categories and subcategories to improve navigation, discoverability, and search engine visibility—all in just two days.","seo":{"title":"Reorganizing our blog for better discovery and SEO | Redocly","description":"Learn how hierarchical categories and subcategories improve blog navigation, user experience, and SEO. See how we reorganized 200+ posts in just two days.","image":"./images/blog-reorganization.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-11-24T00:00:00.000Z","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-reorganization.bf5162d340e10b13fae91c938cc6fb10be36b5c2b497be5adec49ad24a778760.978384e4.png","slug":"/blog/blog-reorganization"},{"template":"../@theme/templates/BlogPost","title":"The unseen economics of an API catalog","description":"Why modern engineering organizations can't operate without one—and how API catalogs deliver measurable ROI through automation, trust, and system visibility.","seo":{"title":"The unseen economics of an API catalog | Redocly","description":"Discover how API catalogs deliver millions in ROI by eliminating search waste, preventing costly mistakes, and enabling faster development through automation and trust.","image":"./images/Redocly_blog_8.jpg"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-11-17","categories":[{"category":{"id":"api-catalog","label":"API catalog"}}],"image":"/assets/redocly_blog_8.cf4b1ba929c6e3576f8b45824b0e30061d6c875b17a2c57c92c2d7f73af74717.978384e4.jpg","slug":"/blog/api-catalog-value"},{"template":"../@theme/templates/BlogPost","title":"Beyond anomaly detection — striving with metrics","description":"Metrics shouldn't only exist for quick error detection. They should exist to help you strive — to set goals, accelerate learning, and achieve meaningful improvement.","seo":{"title":"Beyond anomaly detection — striving with metrics","description":"Metrics shouldn't only exist for quick error detection. They should exist to help you strive — to set goals, accelerate learning, and achieve meaningful improvement.","image":"./images/beyond-anomaly-detection.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-11-11","categories":[{"category":{"id":"api-monitoring","label":"API monitoring"},"subcategory":{"id":"performance-metrics","label":"Performance metrics"}}],"image":"/assets/beyond-anomaly-detection.f1e11158548cc6695ff2205c40e48abbd8f7638f48976f84ffe21112efec6ab9.978384e4.png","slug":"/blog/beyond-anomaly-detection"},{"template":"../@theme/templates/BlogPost","title":"November 2025 updates","description":"Product features and enhancements from November 2025 include AI assistant improvements, OpenAPI 3.2.0 support, enhanced MCP integration, and new CLI validation rules.","seo":{"title":"November 2025 updates","description":"Product features and enhancements from November 2025 include AI assistant improvements, OpenAPI 3.2.0 support, enhanced MCP integration, and new CLI validation rules.","image":"./images/november-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-11-06","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/november-feature-updates.c46c36192468c478766a20386e9052afc815f8e8562c4b4c27ae9d1cef26f049.978384e4.png","slug":"/blog/updates-2025-11"},{"template":"../@theme/templates/BlogPost","title":"Beyond the North Star","description":"Moving beyond the North Star to Orion's Belt of key metrics for docs: Acquisition, Adoption, and Deflection.","seo":{"title":"Key Metrics for Docs","description":"Moving beyond the North Star to Orion's Belt of key metrics for docs: Acquisition, Adoption, and Deflection.","image":"./images/key-metrics-for-docs.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-11-04","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"docs-ux","label":"Documentation UX"}}],"image":"/assets/key-metrics-for-docs.d3f254a4275d93a558fe46f3ba53143be3f29a7fdefef206a839d874ba822a16.978384e4.png","slug":"/blog/key-metrics-for-docs"},{"template":"../@theme/templates/BlogPost","title":"Two approaches to API design - Resources vs Workflows","description":"Exploring resource-first and workflow-first approaches to API design, and why thinking about use cases early can lead to better APIs.","seo":{"title":"Two approaches to API design - Resources vs Workflows","description":"Exploring resource-first and workflow-first approaches to API design, and why thinking about use cases early can lead to better APIs.","image":"./images/api-design-approaches.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-10-28","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/api-design-approaches.d8f8c341efce73ba9749dc5e9f9d84086b4d7a33b3c3bd2a02abd9fd642abd91.978384e4.png","slug":"/blog/api-design-approaches"},{"template":"../@theme/templates/BlogPost","title":"September 2025 updates","description":"Product features and enhancements from September 2025 include built-in MCP server integration, OpenAPI 3.2.0 support, enhanced search capabilities, and improved build processes.","seo":{"title":"September 2025 updates","description":"Product features and enhancements from September 2025 include built-in MCP server integration, OpenAPI 3.2.0 support, enhanced search capabilities, and improved build processes.","image":"./images/september-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-10-09","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/september-updates.811e89d7987970b61a0a544dc1b32506ea12a3ad0262a3d659fc4fe95cb9e39c.978384e4.png","slug":"/blog/updates-2025-09"},{"template":"../@theme/templates/BlogPost","title":"Getting started with API versioning","description":"Take your first steps to better APIs with our approachable guide to getting started with API versioning.","seo":{"title":"Getting started with API versioning","description":"Take your first steps to better APIs with our approachable guide to getting started with API versioning."},"author":{"id":"matt-williams","name":"Matt Williams","authorBIO":"SVP of Marketing, Redocly","image":"/assets/matt-williams.126dc3ab7b0569eb9ea67b3f32cb67d66342c799f68ec70affbab30b169269e5.978384e4.png"},"publishedDate":"2025-09-15","categories":[{"category":{"id":"api-versioning","label":"API versioning"}}],"image":"/assets/getting-started-api-versioning.eafbd812ed3dc02644eb41ff8cb582bd1eb2c22e62a4589bb9a400efc95795f6.978384e4.jpg","slug":"/blog/getting-started-api-versioning"},{"template":"../@theme/templates/BlogPost","title":"August 2025 updates","description":"Product features and enhancements from August 2025 include enhanced AI integration, improved navigation, workflow upgrades, and a robust feedback system.","seo":{"title":"August 2025 updates","description":"Product features and enhancements from August 2025 include enhanced AI integration, improved navigation, workflow upgrades, and a robust feedback system.","image":"./images/aug-blog-post.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-09-11","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/aug-blog-post.683af181d521d804c7e3f4703babd5cafefdb7f92eddf4b64721c665aff4db99.978384e4.png","slug":"/blog/updates-2025-08"},{"template":"../@theme/templates/BlogPost","title":"API versioning best practices","description":"Implementing API versioning strategies that protect existing integrations while enabling safe updates.","seo":{"title":"API versioning best practices","description":"Implementing API versioning strategies that protect existing integrations while enabling safe updates.","image":"./images/api-versioning-best-practices.jpg"},"author":{"id":"matt-williams","name":"Matt Williams","authorBIO":"SVP of Marketing, Redocly","image":"/assets/matt-williams.126dc3ab7b0569eb9ea67b3f32cb67d66342c799f68ec70affbab30b169269e5.978384e4.png"},"publishedDate":"2025-08-20","categories":[{"category":{"id":"api-versioning","label":"API versioning"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}},{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"versioning-comms","label":"Versioning communication"}}],"image":"/assets/api-versioning-best-practices.cff554516ff4a5ac5c620e54eeacdd916593af0bef21e04dfc0cb965a023a90c.978384e4.jpg","slug":"/blog/api-versioning-best-practices"},{"template":"../@theme/templates/BlogPost","title":"llms.txt is overhyped","description":"We built it, tested it, and checked the logs. llms.txt isn’t the “robots.txt for AI” — it’s mostly ignored. Here’s what actually matters.","seo":{"title":"llms.txt is overhyped","description":"Redocly experimented with llms.txt and found it mostly smoke, not fire. See the results, the logs, and what really matters for docs + AI.","image":"./images/llms-txt.jpg"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-08-20","categories":[{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"api-seo","label":"API SEO"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"ai-assisted-docs","label":"AI-assisted documentation"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}},{"category":{"id":"developer-portal","label":"Developer portal"},"subcategory":{"id":"search","label":"Search"}}],"image":"/assets/llms-txt.6f64241e5659ff8c21a207ce5e109b10b5f025269c17cd34fb04e1671574d0f8.978384e4.jpg","slug":"/blog/llms-txt-overhyped"},{"template":"../@theme/templates/BlogPost","title":"June and July 2025 updates","description":"Product features and enhancements from June and July 2025 include analytics, icons, and AsyncAPI docs","seo":{"title":"Summer 2025 Updates: June and July","description":"Product features and enhancements from June and July 2025 include analytics, icons, and AsyncAPI docs","image":"./images/june-july-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-08-18","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/june-july-updates.38765183caf6d8293f43f8a8458288f1a3d49caad5976361bae61008d96e4d19.978384e4.png","slug":"/blog/updates-2025-07"},{"template":"../@theme/templates/BlogPost","title":"How to optimize your docs for LLMs","description":"Let's dig into a few practical strategies to make your API documentation work better with AI tools.","seo":{"title":"How to optimize your docs for LLMs","description":"Let's dig into a few practical strategies to make your API documentation work better with AI tools."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-08-14","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"ai-assisted-docs","label":"AI-assisted documentation"}},{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"reference-docs","label":"Reference docs"}},{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/llm_optimization_funnel_final.fe3b859674895d9cbfcda9e0ac48ed809fd83b243e435a0fc008834f7db5b67f.978384e4.png","slug":"/blog/optimizations-to-make-to-your-docs-for-llms"},{"template":"../@theme/templates/BlogPost","title":"MCP: what it is, why it matters, and why caution is warranted in 2025","description":"Explore the pros and cons of Model Context Protocol (MCP), an emerging standard for AI agent interaction.","seo":{"title":"MCP: what is it, why it matters, and why caution is warranted in 2025","description":"Explore the pros and cons of Model Context Protocol (MCP), an emerging standard for AI agent interaction."},"image":"/assets/mcp-header.2c0a994a7d919845d57f5cb0851c7c3798626bf8ac1ff04ee8eaf41f6b9adedd.978384e4.png","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-07-15","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"contract-patterns","label":"Contract patterns"}}],"slug":"/blog/mcp"},{"template":"../@theme/templates/BlogPost","title":"May 2025 updates","description":"Round-up of product features and enhancements from March, April, and May 2025","seo":{"title":"Q2 2025 Updates: March through May","description":"Round-up of product features and enhancements from March, April, and May 2025","image":"./images/past-quarter.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-06-09","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/past-quarter.3545deb667d1082aab759436150a30c1e2fe19ab8ee44e994af802b0bbf7e076.978384e4.png","slug":"/blog/updates-2025-05"},{"template":"../@theme/templates/BlogPost","title":"February 2025 updates","description":"Round-up of product features and enhancements from February 2025","seo":{"title":"February 2025 updates","description":"Round-up of product features and enhancements from February 2025","image":"./images/february-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-03-18","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/february-feature-updates.fcf0674c9ae13ada76b003020702b9017451a20391252753cd5cc29420891b7b.978384e4.png","slug":"/blog/updates-2025-02"},{"template":"../@theme/templates/BlogPost","title":"Respect your API: Announcing Respect Monitoring","description":"Respect Monitoring is an OpenAPI-aware API monitoring solution that ensures your APIs behave exactly as expected.","seo":{"title":"Respect your API: Announcing Respect Monitoring","description":"Respect Monitoring is an OpenAPI-aware API monitoring solution that ensures your APIs behave exactly as expected.","image":"./images/respect-your-api-blog.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-02-25","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/respect-your-api-blog.a39c522887b330f6842395d39a495a8f93db4f28113dc2afa687ccc06fe1812a.978384e4.png","slug":"/blog/respect"},{"template":"../@theme/templates/BlogPost","title":"Open-sourcing Redocly’s unique approach to dogfooding","seo":{"title":"Open-sourcing Redocly’s unique approach to dogfooding","description":"Phronesis is Redocly's unique approach to dogfooding resulting in 630% improvement in a key metric.","image":"./images/dogfooding.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-02-11","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/dogfooding.660061b0f3e996d2748c1430850b9f5c31754f827e53e9105491c0c054af80c5.978384e4.png","slug":"/blog/phronesis"},{"template":"../@theme/templates/BlogPost","title":"January 2025 updates","description":"Round-up of product features and enhancements from January 2025","seo":{"title":"January 2025 updates","description":"Round-up of product features and enhancements from January 2025","image":"./images/january-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-02-05","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/january-feature-updates.67b9273cfc5e283d06294b20ec4d8cedaeb664b11ab6d11f9da9338d673abd02.978384e4.png","slug":"/blog/updates-2025-01"},{"template":"../@theme/templates/BlogPost","title":"December 2024 updates","description":"Round-up of product features and enhancements from December 2024","seo":{"title":"December 2024 updates","description":"Round-up of product features and enhancements from December 2024","image":"./images/december-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2025-01-06","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/december-feature-updates.23c3bf75de2c63f25bb71c478dbbc7856944a753e9b82bb8645ff1358244521b.978384e4.png","slug":"/blog/updates-2024-12"},{"template":"../@theme/templates/BlogPost","title":"API documentation essentials","description":"Discover how great API documentation helps developers succeed and sets your API apart. Learn the essentials of great API docs.","seo":{"title":"API documentation essentials","description":"Discover how great API documentation helps developers succeed and sets your API apart. Learn the essentials of great API docs."},"author":{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"/assets/taylor-cartoon-headshot.b621d9679c3d7c9361bd5f6ad31a447d4f6146e0f5aa919af4cfde90c2086261.978384e4.png"},"publishedDate":"2024-12-15","categories":[{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"reference-docs","label":"Reference docs"}}],"image":"/assets/blog-2.d88e9d96c48ac2aefdcbd45f89bcb9ff9b6e0a0dc494757bfe7d44868c726726.978384e4.png","slug":"/blog/api-documentation-essentials"},{"template":"../@theme/templates/BlogPost","title":"November 2024 updates","description":"Round-up of product features and enhancements from November 2024","seo":{"title":"November 2024 updates","description":"Round-up of product features and enhancements from November 2024","image":"./images/november-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-12-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/november-feature-updates.c46c36192468c478766a20386e9052afc815f8e8562c4b4c27ae9d1cef26f049.978384e4.png","slug":"/blog/updates-2024-11"},{"template":"../@theme/templates/BlogPost","title":"October 2024 updates","description":"Round-up of product features and enhancements from October 2024","seo":{"title":"October 2024 updates","description":"Round-up of product features and enhancements from October 2024","image":"./images/october-feature-updates.png"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-11-04","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/october-feature-updates.ffd89395b9f7316b443d8fe56182738e0fb11b79947d7bc981b9271ef55edc39.978384e4.png","slug":"/blog/updates-2024-10"},{"template":"../@theme/templates/BlogPost","title":"Docs-as-code is a tech writer productivity hack","description":"Go big on pragmatism and efficiency (and make your writers happy) by using docs-as-code workflows in your documentation projects.","seo":{"title":"Docs-as-code is a tech writer productivity hack","description":"Go big on pragmatism and efficiency (and make your writers happy) by using docs-as-code workflows in your documentation projects."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-10-16","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"}}],"image":"/assets/redocly_blog_3.b83521fac740d6ef04bf8b55792293cd2268920f1a122d6ec6b60015468bdd54.978384e4.jpg","slug":"/blog/docs-as-code-pragmatism"},{"template":"../@theme/templates/BlogPost","title":"Redocly Premium vs Open Source Features","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-10-16","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"pricing-usage","label":"Pricing & usage"}}],"image":"/assets/premium-vs-open-source.496b20b1dc5d39ea02cc913d75927035fb3d3905aa2872ea0dd72f5d580405cf.978384e4.png","seo":{"title":"Redocly Premium vs Open Source Features","description":"Redocly Premium vs Open Source Features explained in depth.","image":"./images/premium-vs-open-source.png","jsonLd":{"@context":"https://schema.org","@type":"BlogPosting","author":[{"@type":"Person","name":"Adam Altman","url":"https://x.com/adamaltman"}],"headline":"Redocly Premium vs Open Source Features","image":["https://redocly.com/blog/images/premium-vs-open-source.png"]}},"slug":"/blog/premium-vs-open-source"},{"template":"../@theme/templates/BlogPost","title":"Redocly Launches New API Tools Suite","description":"Discover Redocly’s newly launched suite of API tools: Reunite, Realm, Redoc, Revel, and Reef. Build, manage, and scale APIs effortlessly. Start your free 30-day trial today!","seo":{"title":"Redocly Launches New API Tools Suite – Start Your Free 30-Day Trial","description":"Discover Redocly’s newly launched suite of API tools: Reunite, Realm, Redoc, Revel, and Reef. Build, manage, and scale APIs effortlessly. Start your free 30-day trial today!"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-10-08","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/redocly_blog_5.79cf160e4084f13931fdc05f76ff50b8140a0d81a8770aa37211a059b3153906.978384e4.jpg","slug":"/blog/launch-2024"},{"template":"../@theme/templates/BlogPost","title":"Improve OpenAPI security with defensive linting rules","description":"Some simple rules to add to your OpenAPI linting setup as a quick way to catch some small but dangerous API mistakes.","seo":{"title":"Improve OpenAPI security with defensive linting rules","description":"Some simple rules to add to your OpenAPI linting setup as a quick way to catch some small but dangerous API mistakes."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-10-02","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"linting-rulesets","label":"Linting & rulesets"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"compliance-quality","label":"Compliance & quality"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/security-ruleset"},{"template":"../@theme/templates/BlogPost","title":"The rise of interactive documentation","description":"Learn how interactive documentation is revolutionizing technical writing, empowering developers with immersive learning experiences and dynamic content.","seo":{"title":"The rise of interactive documentation","description":"Learn how interactive documentation is revolutionizing technical writing, empowering developers with immersive learning experiences and dynamic content."},"author":{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"/assets/taylor-cartoon-headshot.b621d9679c3d7c9361bd5f6ad31a447d4f6146e0f5aa919af4cfde90c2086261.978384e4.png"},"publishedDate":"2024-09-18","categories":[{"category":{"id":"developer-portal","label":"Developer portal"}},{"category":{"id":"docs-as-code","label":"Docs-as-code"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"docs-ux","label":"Documentation UX"}}],"image":"/assets/blog-7.3d497ed5c9740e9f062ef3f08dd33a2e852c57df7ed811ade461ef5a8397fa49.978384e4.jpg","slug":"/blog/rise-of-interactive-documentation"},{"template":"../@theme/templates/BlogPost","title":"Redocly CLI for AsyncAPI descriptions","description":"Embrace multiple specification standards with one tool, Redocly CLI.","seo":{"title":"Redocly CLI for AsyncAPI descriptions","description":"Embrace multiple specification standards with one tool, Redocly CLI."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-09-05","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"asyncapi","label":"AsyncAPI"}}],"image":"/assets/redocly_blog_8.cf4b1ba929c6e3576f8b45824b0e30061d6c875b17a2c57c92c2d7f73af74717.978384e4.jpg","slug":"/blog/asyncapi-features"},{"template":"../@theme/templates/BlogPost","title":"Best practices for building and adopting an API governance strategy","description":"API governance is important. Learn how to do it well.","seo":{"title":"Best practices for building and adopting an API governance strategy","description":"API governance is important. Learn how to do it well."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-08-29","categories":[{"category":{"id":"api-governance","label":"API governance"}}],"image":"/assets/redocly_blog_2.930750a0c879eee4890e2ffea2a38e5cccbb2365dcf4028388bee8ba6aaf261b.978384e4.jpg","slug":"/blog/api-governance-best-practice"},{"template":"../@theme/templates/BlogPost","title":"My favorite new features","description":"Top 8 new features I’m most excited about.","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-08-21","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/favorite-features.7311ce4cccc07cfe8091824ff360a20dc0f42427560d13b0fe1190cd10aceba2.978384e4.png","slug":"/blog/favorite-new-features"},{"template":"../@theme/templates/BlogPost","title":"Redocly 2.0: From Workflows to Reunite","description":"A fresh start to boost your team's efficiency.","seo":{"title":"Redocly 2.0: From Workflows to Reunite","description":"A fresh start to boost your team's efficiency."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-08-13","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/product-mix.95264cd3c232a8a59a79e945dab66956b65689896d3cd6c7fe3814bcac2910f8.978384e4.png","slug":"/blog/migration-to-reunite"},{"template":"../@theme/templates/BlogPost","title":"Rebuilding Redocly's Core","description":"The extended journey which lead to new and exciting products.","seo":{"title":"Rebuilding Redocly's Core","description":"The extended journey which lead to new and exciting products."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-08-07","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/new-core.ea7470aba6eb694a7b5f5ca9c675067f30ba6d7c7f4e7752e8781aa38b4b3523.978384e4.png","slug":"/blog/new-core"},{"template":"../@theme/templates/BlogPost","title":"Redocly Arazzo product roadmap","seo":{"title":"Redocly Arazzo product roadmap"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-07-29","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/arazzo-roadmap.2516d417256e2ef3cb3a89adf58331bf862baa699bab2962ed4be87a0ca74072.978384e4.webp","slug":"/blog/arazzo-roadmap"},{"template":"../@theme/templates/BlogPost","title":"Lint Arazzo workflow files with Redocly CLI","description":"Adopting new standards requires great tools. Use Redocly CLI to lint your OpenAPI, AsyncAPI and Arazzo format descriptions.","seo":{"title":"Lint Arazzo workflow files with Redocly CLI","description":"Adopting new standards requires great tools. Use Redocly CLI to lint your OpenAPI, AsyncAPI and Arazzo format descriptions."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-07-24","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"arazzo","label":"Arazzo"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"linting-rulesets","label":"Linting & rulesets"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/redocly_blog_1.fbb36b4181655e8cd49e9e64e7a53adabe3e117bc50b462211ad7d9ea71dbc8c.978384e4.jpg","slug":"/blog/arazzo-linting"},{"template":"../@theme/templates/BlogPost","title":"Tips for Documentation Migration","description":"Make your documentation migration a huge success with these practical tips on planning, collaboration, and quality checks.","seo":{"title":"Tips for Documentation Migration","description":"Make your next documentation migration a huge success with these practical tips on planning, collaboration, and quality checks."},"author":{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"/assets/taylor-cartoon-headshot.b621d9679c3d7c9361bd5f6ad31a447d4f6146e0f5aa919af4cfde90c2086261.978384e4.png"},"publishedDate":"2024-07-17","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"writing-style","label":"Writing style"}},{"category":{"id":"api-versioning","label":"API versioning"},"subcategory":{"id":"migrations","label":"Migrations"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","slug":"/blog/documentation-migration-tips"},{"template":"../@theme/templates/BlogPost","title":"Git branching strategies for documentation projects","description":"Docs-as-code workflows need solid branching strategies. This article helps you pick the right one.","seo":{"title":"Git branching strategies for documentation projects","description":"Docs-as-code workflows need solid branching strategies. This article helps you pick the right one."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-07-04","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"},"subcategory":{"id":"git-workflows","label":"Git workflows"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/git-branching-for-docs"},{"template":"../@theme/templates/BlogPost","title":"YAML basics for Technical Writers","description":"YAML is a data format, used in many documentation tools. Learn all you need to work effectively with YAML.","seo":{"title":"YAML basics for Technical Writers","description":"YAML is a data format, used in many documentation tools. Learn all you need to work effectively with YAML."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-06-19","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"tutorials-onboarding","label":"Tutorials & onboarding"}}],"image":"/assets/redocly_blog_1.fbb36b4181655e8cd49e9e64e7a53adabe3e117bc50b462211ad7d9ea71dbc8c.978384e4.jpg","slug":"/blog/get-started-yaml"},{"template":"../@theme/templates/BlogPost","title":"OpenAPI parameter types for great API design","description":"Great API design makes for great API experience. Pick the parameter type that's going to make everything easier for your user.","seo":{"title":"OpenAPI parameter types for great API design","description":"Great API design makes for great API experience. Pick the parameter type that's going to make everything easier for your user."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-06-06","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/openapi-parameter-types"},{"template":"../@theme/templates/BlogPost","title":"What to do when your API changes","description":"APIs change, that's reality. What matters is how you communicate that; get it right and create a winning API experience by adding a changelog and API description versions.","seo":{"title":"What to do when your API changes","description":"APIs change, that's reality. What matters is how you communicate that; get it right and create a winning API experience by adding a changelog and API description versions."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-05-22","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"versioning-comms","label":"Versioning communication"}}],"image":"/assets/redocly_blog_8.cf4b1ba929c6e3576f8b45824b0e30061d6c875b17a2c57c92c2d7f73af74717.978384e4.jpg","slug":"/blog/communicate-api-changes"},{"template":"../@theme/templates/BlogPost","title":"Ensure consistent APIs with Redocly and GitHub Actions","description":"Put some magic API tools in your continuous integration and make a good API grow up to be a great API.","seo":{"title":"Ensure consistent APIs with Redocly and GitHub Actions","description":"Put some magic API tools in your continuous integration and make a good API grow up to be a great API."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-05-15","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"review-workflows","label":"Review workflows"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/consistent-apis-redocly-github-actions"},{"template":"../@theme/templates/BlogPost","title":"Getting started with API governance","description":"Take your first steps to better APIs with our approachable guide to getting started with API governance.","seo":{"title":"Getting started with API governance","description":"Take your first steps to better APIs with our approachable guide to getting started with API governance."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-05-08","categories":[{"category":{"id":"api-governance","label":"API governance"}}],"image":"/assets/redocly_blog_2.930750a0c879eee4890e2ffea2a38e5cccbb2365dcf4028388bee8ba6aaf261b.978384e4.jpg","slug":"/blog/getting-started-api-governance"},{"template":"../@theme/templates/BlogPost","title":"Making metrics at WriteTheDocs Portland 2024","description":"Learn about the importance in using research and metrics in creating value for readers and demonstrating value as writers, as well as some highlights from the talks.","seo":{"title":"Making metrics at WriteTheDocs Portland 2024","description":"Learn about the importance in using research and metrics in creating value for readers and demonstrating value as writers, as well as some highlights from the talks."},"author":{"id":"heather-cloward","name":"Heather Cloward","authorBIO":"Technical Writer, Redocly","image":"/assets/heather.6037daafc7d90ad1176875271c0ab9ab29956d3b2e838e06cd8fbc16a2e24824.978384e4.png"},"publishedDate":"2024-04-25","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"writing-style","label":"Writing style"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","slug":"/blog/wtd-2024"},{"template":"../@theme/templates/BlogPost","title":"API council: the wisdom of your API crowd","description":"Invite the stakeholders inside your organization to the table and make your API the best it can be","seo":{"title":"API council: the wisdom of your API crowd","description":"Invite the stakeholders inside your organization to the table and make your API the best it can be"},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-04-17","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/redocly_blog_8.cf4b1ba929c6e3576f8b45824b0e30061d6c875b17a2c57c92c2d7f73af74717.978384e4.jpg","slug":"/blog/api-council"},{"template":"../@theme/templates/BlogPost","title":"Meet the Museum OpenAPI description","description":"Learn about the Museum API, a modern OpenAPI example by Redocly designed to teach API enthusiasts about OpenAPI and developer experience.","seo":{"title":"Meet the Museum OpenAPI description","description":"Learn about the Museum API, a modern OpenAPI example by Redocly designed to teach API enthusiasts about OpenAPI and developer experience."},"author":{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"/assets/taylor-cartoon-headshot.b621d9679c3d7c9361bd5f6ad31a447d4f6146e0f5aa919af4cfde90c2086261.978384e4.png"},"publishedDate":"2024-03-21","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"tutorials-onboarding","label":"Tutorials & onboarding"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","slug":"/blog/museum-api-introduction"},{"template":"../@theme/templates/BlogPost","title":"Add OpenAPI tags for next-level API descriptions","description":"Tag your OpenAPI endpoints and help your users navigate their own path to success.","seo":{"title":"Add OpenAPI tags for next-level API descriptions","description":"Tag your OpenAPI endpoints and help your users navigate their own path to success."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-03-13","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/add-openapi-tags-for-next-level-api-descriptions"},{"template":"../@theme/templates/BlogPost","title":"Love letter to OpenAPI's info section","description":"How some humble metadata can multiply the impact of your API.","seo":{"title":"Love letter to OpenAPI's info section","description":"How some humble metadata can multiply the impact of your API."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-03-07","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/redocly_blog_6.3d6a98ac902e018a33e5a53ef47a306e043108c9bf9efd992324b75c2c80ebdc.978384e4.jpg","slug":"/blog/loveletter-to-openapi-info"},{"template":"../@theme/templates/BlogPost","title":"Better examples for better API experience","description":"Set API consumers up for success with good and meaningful OpenAPI examples.","seo":{"title":"Better examples for better API experience","description":"Set API consumers up for success with good and meaningful OpenAPI examples."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-02-28","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/redocly_blog_3.b83521fac740d6ef04bf8b55792293cd2268920f1a122d6ec6b60015468bdd54.978384e4.jpg","slug":"/blog/openapi-examples"},{"template":"../@theme/templates/BlogPost","title":"Lint OpenAPI, lint Markdown. Now lint Markdown in OpenAPI.","description":"Use Redocly's API tooling to apply custom validation to your API descriptions, such as checking Markdown is valid.","seo":{"title":"Lint OpenAPI, lint Markdown. Now lint Markdown in OpenAPI.","description":"Use Redocly's API tooling to apply custom validation to your API descriptions, such as checking Markdown is valid."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-02-14","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"linting-rulesets","label":"Linting & rulesets"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"review-workflows","label":"Review workflows"}}],"image":"/assets/redocly_blog_5.79cf160e4084f13931fdc05f76ff50b8140a0d81a8770aa37211a059b3153906.978384e4.jpg","slug":"/blog/lint-markdown"},{"template":"../@theme/templates/BlogPost","title":"Combine OpenAPI Files","description":"Make one coherent API from split definitions or multiple API descriptions using Redocly CLI.","seo":{"title":"Combine OpenAPI Files","description":"Make one coherent API from split definitions or multiple API descriptions using Redocly CLI."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-02-02","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/redocly_blog_1.fbb36b4181655e8cd49e9e64e7a53adabe3e117bc50b462211ad7d9ea71dbc8c.978384e4.jpg","slug":"/blog/combining-openapis"},{"template":"../@theme/templates/BlogPost","title":"Rethinking sub-resources in API design","description":"A lesson from the trenches","seo":{"title":"Rethinking sub-resources in API design","description":"Avoid sub-resources to minimize future rework."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-01-24","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/no-subresources"},{"template":"../@theme/templates/BlogPost","title":"Build your own API guidelines","description":"Build better APIs using API guidelines. Use our interactive quiz to define your API ruleset in collaboration with your team.","seo":{"title":"Build your own API guidelines","description":"Build better APIs using API guidelines. Use our interactive quiz to define your API ruleset in collaboration with your team."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2024-01-17","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"linting-rulesets","label":"Linting & rulesets"}}],"image":"/assets/redocly_blog_2.930750a0c879eee4890e2ffea2a38e5cccbb2365dcf4028388bee8ba6aaf261b.978384e4.jpg","slug":"/blog/build-your-own-api-guidelines"},{"template":"../@theme/templates/BlogPost","title":"From survival to revival in 2023","description":"From survival to revival in 2023","seo":{"title":"From survival to revival in 2023","description":"From survival to revival in 2023"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2024-01-09","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/end-of-year-2023"},{"template":"../@theme/templates/BlogPost","title":"Your linting rulesets are not your API governance","description":"Beyond the code, API style guides define the identity and values of your API","author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-12-14","categories":[{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"linting-rulesets","label":"Linting & rulesets"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"compliance-quality","label":"Compliance & quality"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"review-workflows","label":"Review workflows"}}],"image":"/assets/redocly_blog_5.79cf160e4084f13931fdc05f76ff50b8140a0d81a8770aa37211a059b3153906.978384e4.jpg","slug":"/blog/rulesets-are-not-governance"},{"template":"../@theme/templates/BlogPost","title":"OpenAPI Operation IDs make good API design","description":"Use Operation IDs to write better, more valuable API descriptions and improve developer experience.","seo":{"title":"OpenAPI Operation IDs make good API design","description":"Use Operation IDs to write better, more valuable API descriptions and improve developer experience."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-11-29","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/redocly_blog_6.3d6a98ac902e018a33e5a53ef47a306e043108c9bf9efd992324b75c2c80ebdc.978384e4.jpg","slug":"/blog/operationid-is-api-design"},{"template":"../@theme/templates/BlogPost","title":"Cookbook for better Redocly CLI recipes","description":"Use recipes from the Redocly CLI Cookbook to level up your OpenAPI development and build better APIs.","seo":{"title":"Cookbook for better Redocly CLI recipes","description":"Use recipes from the Redocly CLI Cookbook to level up your OpenAPI development and build better APIs."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-11-16","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/redocly_blog_7.501918c9ffce86984fb708762b7e128e55f2285db340e6196ac990b2f23118a2.978384e4.jpg","slug":"/blog/redocly-cli-cookbook"},{"template":"../@theme/templates/BlogPost","title":"Using Redocly tools for better OpenAPI development","description":"Learn how Redocly's open source tools create a better developer experience when building an OpenAPI description.","seo":{"title":"Using Redocly tools for better OpenAPI development","description":"Learn how Redocly's open source tools create a better developer experience when building an OpenAPI description."},"author":{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"/assets/taylor-cartoon-headshot.b621d9679c3d7c9361bd5f6ad31a447d4f6146e0f5aa919af4cfde90c2086261.978384e4.png"},"publishedDate":"2023-11-08","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/redocly-tools-better-openapi-development"},{"template":"../@theme/templates/BlogPost","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2023-11-03","categories":[{"category":{"id":"api-governance","label":"API governance"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"lifecycle-gates","label":"Lifecycle gates"}}],"image":"/assets/design-build-run-governance.71e4520e9214ea0b03bb3671d33423a7760f56db1365c00c3c172d494eebddfb.978384e4.png","title":"API Governance: Shift-Left to Save Money and Accelerate Velocity","description":"I'll walk you through why when it comes to API governance shifting left is the way to go and how to actually do it.","seo":{"title":"API Governance: Shift-Left to Save Money and Accelerate Velocity","description":"I'll walk you through why when it comes to API governance shifting left is the way to go and how to actually do it.","image":"./images/design-build-run-governance.png","jsonLd":{"@context":"https://schema.org","@type":"BlogPosting","author":[{"@type":"Person","name":"Adam Altman","url":"https://twitter.com/adamaltman"}],"headline":"API Governance: Shift-Left to Save Money and Accelerate Velocity","image":["https://redocly.com/blog/images/design-build-run-governance.png"]}},"slug":"/blog/shift-left-governance"},{"template":"../@theme/templates/BlogPost","title":"RFC 9457: Better information for bad situations","description":"RFC 9457 evolves the standard for describing API errors by building on RFC 7807. Come learn what's new, what to expect, and how you can use it in your own APIs.","seo":{"title":"RFC 9457: Better information for bad situations","description":"RFC 9457 evolves the standard for describing API errors by building on RFC 7807. Come learn what's new, what to expect, and how you can use it in your own APIs."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-10-25","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/redocly_blog_8.cf4b1ba929c6e3576f8b45824b0e30061d6c875b17a2c57c92c2d7f73af74717.978384e4.jpg","slug":"/blog/problem-details-9457"},{"template":"../@theme/templates/BlogPost","title":"Document webhooks with OpenAPI","description":"Great developer experiences for reactive API endpoints","seo":{"title":"Document Webhooks with OpenAPI | Redocly","description":"Learn about webhooks, their impact on modern apps, and how to document them effectively using OpenAPI."},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-09-27","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/redocly_blog_2.930750a0c879eee4890e2ffea2a38e5cccbb2365dcf4028388bee8ba6aaf261b.978384e4.jpg","slug":"/blog/document-webhooks-with-openapi"},{"template":"../@theme/templates/BlogPost","title":"Build rich developer experiences with Markdown in OpenAPI","description":"Make a good API experience a great one with rich descriptions in OpenAPI","seo":{"title":"Build rich developer experiences with Markdown in OpenAPI","description":"Make a good API experience a great one with rich descriptions in OpenAPI"},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-09-19","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"technical-documentation","label":"Technical documentation"}}],"image":"/assets/redocly_blog_3.b83521fac740d6ef04bf8b55792293cd2268920f1a122d6ec6b60015468bdd54.978384e4.jpg","slug":"/blog/markdown-in-openapi"},{"template":"../@theme/templates/BlogPost","title":"Tame your OpenAPI descriptions","description":"Use the best modern tools to make even the longest OpenAPI file a delight to work with","seo":{"title":"Tame your OpenAPI descriptions","description":"Use the best modern tools to make even the longest OpenAPI file a delight to work with"},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-09-06","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"technical-documentation","label":"Technical documentation"}}],"image":"/assets/cli.fa8e21a5046048a9bfd9f13a81c927211e33979af473a4439e17b50d2403e31c.978384e4.png","slug":"/blog/tame-openapi"},{"template":"../@theme/templates/BlogPost","title":"Content reuse","description":"Avoiding common pitfalls when implementing content reuse.","seo":{"title":"Content reuse","description":"Avoiding common pitfalls when implementing content reuse."},"author":{"id":"heather-cloward","name":"Heather Cloward","authorBIO":"Technical Writer, Redocly","image":"/assets/heather.6037daafc7d90ad1176875271c0ab9ab29956d3b2e838e06cd8fbc16a2e24824.978384e4.png"},"publishedDate":"2023-08-30","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"},"subcategory":{"id":"content-reuse","label":"Content reuse"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","slug":"/blog/content-reuse"},{"template":"../@theme/templates/BlogPost","title":"Instant API docs with Redocly","description":"Use Redocly CLI to transform OpenAPI to friendly HTML","seo":{"title":"Instant API docs with Redocly","description":"Use Redocly CLI to transform OpenAPI to friendly HTML"},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-08-22","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"tutorials-onboarding","label":"Tutorials & onboarding"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/redocly-cli-docs"},{"template":"../@theme/templates/BlogPost","title":"Announcing Redocly CLI 1.0","description":"The OpenAPI CLI utility reaches a milestone stable release","seo":{"title":"Announcing Redocly CLI 1.0","description":"The OpenAPI CLI utility reaches a milestone stable release"},"author":{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"/assets/lorna.da3a5a803036d5d06a1412a90112292fea17576f8b2f439f5acecfc744f6b89b.978384e4.png"},"publishedDate":"2023-08-16","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/cli.fa8e21a5046048a9bfd9f13a81c927211e33979af473a4439e17b50d2403e31c.978384e4.png","slug":"/blog/redocly-cli-1-0"},{"template":"../@theme/templates/BlogPost","title":"API into AI","description":"Smooth management transition and new product announcement.","seo":{"title":"API into AI","description":"Smooth management transition and new product announcement."},"author":{"id":"mada-namtla","name":"Mada Namtla","image":"/assets/mada.86f89bf146403de37e1818dc82401cf0e8dab8fabae272a811e884a7c3f11aaf.978384e4.png"},"publishedDate":"2023-04-01","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/p-remover.903872ac09ed377775cb8500079e0e5a026fbd2f6a2e232ebbd9a430d84eedc7.978384e4.png","slug":"/blog/api-into-ai"},{"template":"../@theme/templates/BlogPost","title":"Learn OpenAPI in a day","description":"Accelerated learning approach applied to OpenAPI.","seo":{"title":"Learn OpenAPI in a day","description":"Accelerated learning approach applied to OpenAPI."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2023-02-21","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"tutorials-onboarding","label":"Tutorials & onboarding"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/accelerated-learning-openapi"},{"template":"../@theme/templates/BlogPost","title":"A challenging year","description":"A review of 2022 at Redocly","seo":{"title":"A challenging year","description":"A review of 2022 at Redocly"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2023-01-08","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/end-of-year-2022"},{"template":"../@theme/templates/BlogPost","title":"A tech writer's guide to the Redocly galaxy (part 3)","description":"Introducting Redocly CLI and Redoc","seo":{"title":"A tech writer's guide to the Redocly galaxy (part 3)","description":"Introducting Redocly CLI and Redoc"},"author":{"id":"jody-winter","name":"Jody Winter","image":"/assets/jody-winter.9260c2e619dea8ed1323db66b077ffff3a048d4e2e7af0acc4a6d58a425bccc9.978384e4.png"},"publishedDate":"2022-12-12","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/tech-writer-guide-03"},{"template":"../@theme/templates/BlogPost","title":"A tech writer's guide to the Redocly galaxy (part 2)","description":"What exactly are 'API Docs'?","seo":{"title":"A tech writer's guide to the Redocly galaxy (part 2)","description":"What exactly are 'API Docs'?"},"author":{"id":"jody-winter","name":"Jody Winter","image":"/assets/jody-winter.9260c2e619dea8ed1323db66b077ffff3a048d4e2e7af0acc4a6d58a425bccc9.978384e4.png"},"publishedDate":"2022-11-29","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"conceptual-documentation","label":"Conceptual documentation"}}],"image":"/assets/blog-6.822ab26fb3d8a9b21dc8c66e365a15d874c6e0966fa14dbde95ececc06734fa6.978384e4.png","slug":"/blog/tech-writer-guide-02"},{"template":"../@theme/templates/BlogPost","title":"A tech writer's guide to the Redocly galaxy","description":"A new series for tech writers about docs-as-code","seo":{"title":"A tech writer's guide to the Redocly galaxy","description":"A new series for tech writers about docs-as-code"},"author":{"id":"jody-winter","name":"Jody Winter","image":"/assets/jody-winter.9260c2e619dea8ed1323db66b077ffff3a048d4e2e7af0acc4a6d58a425bccc9.978384e4.png"},"publishedDate":"2022-11-03","categories":[{"category":{"id":"technical-documentation","label":"Technical documentation"},"subcategory":{"id":"tutorials-onboarding","label":"Tutorials & onboarding"}}],"image":"/assets/cli.fa8e21a5046048a9bfd9f13a81c927211e33979af473a4439e17b50d2403e31c.978384e4.png","slug":"/blog/tech-writer-guide-01"},{"template":"../@theme/templates/BlogPost","title":"September 2022 updates","description":"Round-up of product features and enhancements from September 2022","seo":{"title":"September 2022 updates","description":"Round-up of product features and enhancements from September 2022"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-10-04","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/updates-2022-09"},{"template":"../@theme/templates/BlogPost","title":"August 2022 updates","description":"Round-up of product features and enhancements from August 2022","seo":{"title":"August 2022 updates","description":"Round-up of product features and enhancements from August 2022"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-09-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/updates-2022-08"},{"template":"../@theme/templates/BlogPost","title":"How to hide the download button","description":"Answering real questions about how to use OpenAPI to design and describe APIs.","seo":{"title":"How to hide the download button","description":"Answering real questions about how to use OpenAPI to design and describe APIs."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-08-10","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/hide-download-button"},{"template":"../@theme/templates/BlogPost","title":"Redocly for technical writers","description":"How Redocly helps technical writers create superior documentation experiences","seo":{"title":"Redocly for technical writers","description":"How Redocly helps technical writers create superior documentation experiences"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2022-08-05","categories":[{"category":{"id":"developer-portal","label":"Developer portal"}},{"category":{"id":"docs-as-code","label":"Docs-as-code"}},{"category":{"id":"technical-documentation","label":"Technical documentation"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"review-workflows","label":"Review workflows"}}],"image":"/assets/workflows.3eb9e6233ed54c01e56fbc7ef66291faa9ea4a94475d1521ff5f0bf3b04d92b3.978384e4.png","slug":"/blog/redocly-for-tech-writers"},{"template":"../@theme/templates/BlogPost","title":"July 2022 updates","description":"Round-up of product features and enhancements from May, June, and July 2022","seo":{"title":"July 2022 updates","description":"Round-up of product features and enhancements from May, June, and July 2022"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-08-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-7.3d497ed5c9740e9f062ef3f08dd33a2e852c57df7ed811ade461ef5a8397fa49.978384e4.jpg","slug":"/blog/updates-2022-07"},{"template":"../@theme/templates/BlogPost","title":"How to display schemas separately from operations in API docs?","description":"Answering real questions about how to use OpenAPI to design and describe APIs.","seo":{"title":"How to display schemas separately from operations in API docs?","description":"Answering real questions about how to use OpenAPI to design and describe APIs."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-05-26","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","slug":"/blog/display-schemas"},{"template":"../@theme/templates/BlogPost","title":"OpenAPI overlays","description":"The OpenAPI overlays proposal is flawed.","seo":{"title":"OpenAPI overlays","description":"The OpenAPI overlays proposal is flawed."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-05-25","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/openapi-overlays"},{"template":"../@theme/templates/BlogPost","title":"How to hide the x-logo","description":"Answering real questions about how to use OpenAPI to design and describe APIs.","seo":{"title":"How to hide the x-logo","description":"Answering real questions about how to use OpenAPI to design and describe APIs."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-05-11","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/hide-logo"},{"template":"../@theme/templates/BlogPost","title":"How to reuse schemas when required properties change across endpoints","description":"Answering real questions about how to use OpenAPI to design and describe APIs.","seo":{"title":"How to reuse schemas when required properties change across endpoints","description":"Answering real questions about how to use OpenAPI to design and describe APIs."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-05-04","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/all-of-schemas"},{"template":"../@theme/templates/BlogPost","title":"April 2022 updates","description":"Round-up of product features and enhancements from April 2022","seo":{"title":"April 2022 updates","description":"Round-up of product features and enhancements from April 2022"},"author":{"id":"ivana-devcic","name":"Ivana Isadora Devcic","authorBIO":"Technical Writer, Redocly","image":"/assets/ivana.2e60e7676ffdccc30ed04a66abcf82e185c1850d74aef28a0533b949ab0a7dd3.978384e4.png"},"publishedDate":"2022-05-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-7.3d497ed5c9740e9f062ef3f08dd33a2e852c57df7ed811ade461ef5a8397fa49.978384e4.jpg","keywords":{"excludes":["sidebar","sidebars"]},"slug":"/blog/updates-2022-04"},{"template":"../@theme/templates/BlogPost","title":"March 2022 updates","description":"Round up of product features and enhancements, plus documentation news from March 2022","seo":{"title":"March 2022 updates","description":"Round up of product features and enhancements, plus documentation news from March 2022"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2022-04-04","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/updates-2022-03"},{"template":"../@theme/templates/BlogPost","title":"Redocly is Remockly","seo":{"title":"Redocly is Remockly"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-04-01","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/remockly-logo.2e714a621937b6e33675f783c7fdd7e2525ed2a0307f507e43a52fa15be0198f.978384e4.png","slug":"/blog/redocly-is-remockly"},{"template":"../@theme/templates/BlogPost","title":"February 2022 updates","description":"Round up of product features and enhancements, plus documentation news from February 2022","seo":{"title":"February 2022 updates","description":"Round up of product features and enhancements, plus documentation news from February 2022"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2022-03-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-6.822ab26fb3d8a9b21dc8c66e365a15d874c6e0966fa14dbde95ececc06734fa6.978384e4.png","slug":"/blog/updates-2022-02"},{"template":"../@theme/templates/BlogPost","title":"Ukraine war update","description":"Address current events and the impact to our team.","seo":{"title":"Ukraine war update","description":"Address current events and the impact to our team."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-02-27","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/ukraine-flag.69bd65a15778380b035c77d80177840db5cdd56ed6f557f12c1a0013d2d29dc8.978384e4.svg","slug":"/blog/ukraine-war"},{"template":"../@theme/templates/BlogPost","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-02-11","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}},{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"api-seo","label":"API SEO"}}],"image":"/assets/redocly-mailbox-sq.c72d4fc0c1d2be6fcf811806f01047e4076a284948df0c127a05c810a5033145.978384e4.png","title":"What's an API?","description":"API is an acronym for application programming interface.","seo":{"title":"What's an API?","description":"API is an acronym for application programming interface.","image":"./images/redocly-mailbox-sq.png"},"slug":"/blog/whats-an-api"},{"template":"../@theme/templates/BlogPost","title":"January 2022 updates","description":"Round up of product features and enhancements, plus documentation news from January 2022","seo":{"title":"January 2022 updates","description":"Round up of product features and enhancements, plus documentation news from January 2022"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2022-02-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","slug":"/blog/updates-2022-01"},{"template":"../@theme/templates/BlogPost","title":"Tech stack","description":"(Don't) build your Redocly","seo":{"title":"Tech stack","description":"(Don't) build your Redocly"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2022-02-01","categories":[{"category":{"id":"developer-portal","label":"Developer portal"}}],"image":"/assets/intern-to-build.f941ce87eb0967a5dcfeecb1c61e6f1972e8fe4d0fbca2a1b53ed870555b82fe.978384e4.png","slug":"/blog/tech-stack"},{"template":"../@theme/templates/BlogPost","title":"Upward and onward at Redocly","description":"Highlighting the most interesting and useful features Redocly delivered in 2021","seo":{"title":"Upward and onward at Redocly","description":"Highlighting the most interesting and useful features Redocly delivered in 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-12-25","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/end-of-year-2021"},{"template":"../@theme/templates/BlogPost","title":"November 2021 updates","description":"Round up of product features and enhancements, plus documentation news from November 2021","seo":{"title":"November 2021 updates","description":"Round up of product features and enhancements, plus documentation news from November 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-12-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-6.822ab26fb3d8a9b21dc8c66e365a15d874c6e0966fa14dbde95ececc06734fa6.978384e4.png","slug":"/blog/updates-2021-11"},{"template":"../@theme/templates/BlogPost","author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2021-11-30","categories":[{"category":{"id":"developer-portal","label":"Developer portal"}},{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"api-seo","label":"API SEO"}}],"image":"/assets/seo-api-docs.565198acb2b18d08e83dd286c4bc1b489473411be182e3d4d05c336d18e36b00.978384e4.jpg","title":"SEO the API docs","description":"SEO is an excellent API marketing technique.","seo":{"title":"SEO the API docs","description":"SEO is an excellent API marketing technique.","image":"./images/seo-960x540-ratio16-9.jpg","jsonLd":{"@context":"https://schema.org","@type":"BlogPosting","author":[{"@type":"Person","name":"Adam Altman","url":"https://twitter.com/adamaltman"}],"headline":"SEO the API docs","image":["https://redocly.com/blog/images/seo-api-docs.jpg","https://redocly.com/blog/images/seo-700x700-ratio1-1.jpg","https://redocly.com/blog/images/seo-960x540-ratio16-9.jpg","https://redocly.com/blog/images/seo-960x720-ratio4-3.jpg"]}},"slug":"/blog/seo-api-docs"},{"template":"../@theme/templates/BlogPost","title":"5 reasons why you should install the Redocly VS Code extension","description":"Announcing the new release and presenting new features in the Redocly VS Code extension","seo":{"title":"5 reasons why you should install the Redocly VS Code extension","description":"Announcing the new release and presenting new features in the Redocly VS Code extension"},"author":{"id":"ivana-devcic","name":"Ivana Isadora Devcic","authorBIO":"Technical Writer, Redocly","image":"/assets/ivana.2e60e7676ffdccc30ed04a66abcf82e185c1850d74aef28a0533b949ab0a7dd3.978384e4.png"},"publishedDate":"2021-11-16","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redocly-cli","label":"Redocly CLI"}}],"image":"/assets/cli.fa8e21a5046048a9bfd9f13a81c927211e33979af473a4439e17b50d2403e31c.978384e4.png","slug":"/blog/new-release-redocly-openapi-vscode-extension"},{"template":"../@theme/templates/BlogPost","title":"October 2021 updates","description":"Round up of product features and enhancements, plus documentation news from October 2021","seo":{"title":"October 2021 updates","description":"Round up of product features and enhancements, plus documentation news from October 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-11-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","slug":"/blog/updates-2021-10"},{"template":"../@theme/templates/BlogPost","title":"September 2021 updates","description":"Round up of product features and enhancements, plus documentation news from September 2021","seo":{"title":"September 2021 updates","description":"Round up of product features and enhancements, plus documentation news from September 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-10-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","slug":"/blog/updates-2021-09"},{"template":"../@theme/templates/BlogPost","title":"August 2021 updates","description":"Round up of product features and enhancements, plus some documentation news from August 2021","seo":{"title":"August 2021 updates","description":"Round up of product features and enhancements, plus some documentation news from August 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-09-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-8.33d5486a9754f30c879792b1bf9f64911a6f4c42149cf4493fa5bff4bd8a79c0.978384e4.jpg","slug":"/blog/updates-2021-08"},{"template":"../@theme/templates/BlogPost","title":"July 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from July 2021","seo":{"title":"July 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from July 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-08-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-7.3d497ed5c9740e9f062ef3f08dd33a2e852c57df7ed811ade461ef5a8397fa49.978384e4.jpg","slug":"/blog/updates-2021-07"},{"template":"../@theme/templates/BlogPost","title":"Announcing Reference docs 2.0","description":"Presenting the redesign and release of Reference docs 2.0","seo":{"title":"Announcing Reference docs 2.0","description":"Presenting the redesign and release of Reference docs 2.0"},"author":{"id":"ivana-devcic","name":"Ivana Isadora Devcic","authorBIO":"Technical Writer, Redocly","image":"/assets/ivana.2e60e7676ffdccc30ed04a66abcf82e185c1850d74aef28a0533b949ab0a7dd3.978384e4.png"},"publishedDate":"2021-07-07","categories":[{"category":{"id":"api-documentation","label":"API documentation"},"subcategory":{"id":"reference-docs","label":"Reference docs"}},{"category":{"id":"docs-as-code","label":"Docs-as-code"}}],"image":"/assets/refdocs.bbb0c598669f5fcc4ed106cf15eb57362166b4f9632eccc273e27c6fbb97101f.978384e4.png","slug":"/blog/reference-docs-redesign"},{"template":"../@theme/templates/BlogPost","title":"June 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from June 2021","seo":{"title":"June 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from June 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-07-02","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-6.822ab26fb3d8a9b21dc8c66e365a15d874c6e0966fa14dbde95ececc06734fa6.978384e4.png","slug":"/blog/updates-2021-06"},{"template":"../@theme/templates/BlogPost","title":"May 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from May 2021","seo":{"title":"May 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from May 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-06-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","slug":"/blog/updates-2021-05"},{"template":"../@theme/templates/BlogPost","title":"April 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from April 2021","seo":{"title":"April 2021 updates","description":"Round up of the features and enhancements, plus some documentation news from April 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-05-04","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-1.753b471e3972ae806c366fa4121f910f01d36e9db9352df290c7446c8528c7ba.978384e4.png","slug":"/blog/updates-2021-04"},{"template":"../@theme/templates/BlogPost","title":"March 2021 updates","description":"Round up of the features and enhancements Redocly delivered in March 2021","seo":{"title":"March 2021 updates","description":"Round up of the features and enhancements Redocly delivered in March 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-04-01","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","slug":"/blog/updates-2021-03"},{"template":"../@theme/templates/BlogPost","title":"February 2021 updates","description":"Quick round up of the features and enhancements Redocly delivered in February 2021","seo":{"title":"February 2021 updates","description":"Quick round up of the features and enhancements Redocly delivered in February 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-03-05","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/features.b1ca9366278f76778166e33c15f2392b33a84311e1b6bb1fa34583591354dbb3.978384e4.png","slug":"/blog/updates-2021-02"},{"template":"../@theme/templates/BlogPost","title":"January 2021 updates","description":"Quick round up of the features and enhancements Redocly delivered in January 2021","seo":{"title":"January 2021 updates","description":"Quick round up of the features and enhancements Redocly delivered in January 2021"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-02-08","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/built.24d56fa7bc6ca91078f65fad9ef6978d2a08a834ed7186d9eade44aec95009b4.978384e4.png","slug":"/blog/updates-2021-01"},{"template":"../@theme/templates/BlogPost","title":"Presenting multiple APIs for better discovery","seo":{"title":"Presenting multiple APIs for better discovery"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2021-01-26","categories":[{"category":{"id":"api-catalog","label":"API catalog"},"subcategory":{"id":"discovery","label":"Discovery"}}],"image":"/assets/blog-api-discovery.b054618f45c5830e544abe34dfa7eab32015e2fb26657558616c259c58fc9cf9.978384e4.png","keywords":{"excludes":["sidebar","sidebars"]},"slug":"/blog/api-discovery"},{"template":"../@theme/templates/BlogPost","title":"Where to store your OpenAPI definitions","description":"Part 1 of our series of posts around managing OpenAPI definitions with Redocly","seo":{"title":"Where to store your OpenAPI definitions","description":"Part 1 of our series of posts around managing OpenAPI definitions with Redocly"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2021-01-07","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}},{"category":{"id":"api-governance","label":"API governance"},"subcategory":{"id":"review-workflows","label":"Review workflows"}},{"category":{"id":"technical-documentation","label":"Technical documentation"}}],"image":"/assets/team.2ec6961c22c7907b97d538b6436b0c1343c6f762d13b2f334075b757aee87ac5.978384e4.png","slug":"/blog/store-openapi-definitions"},{"template":"../@theme/templates/BlogPost","title":"What Redocly brought to the API space in 2020","description":"Highlighting the most interesting/useful features Redocly delivered in 2020","seo":{"title":"What Redocly brought to the API space in 2020","description":"Highlighting the most interesting/useful features Redocly delivered in 2020"},"author":{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"/assets/swapnil.3df7e141d9a250ae62b64d9767af0b63cf8ab801d80eec4ff6ba2b67fa14ac15.978384e4.png"},"publishedDate":"2020-12-30","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"product-updates","label":"Product updates"}}],"image":"/assets/features.b1ca9366278f76778166e33c15f2392b33a84311e1b6bb1fa34583591354dbb3.978384e4.png","slug":"/blog/end-of-year-2020"},{"template":"../@theme/templates/BlogPost","title":"The top three reasons I love docs-as-code","seo":{"title":"The top three reasons I love docs-as-code"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2020-10-29","categories":[{"category":{"id":"docs-as-code","label":"Docs-as-code"}}],"image":"/assets/blog-5.363f248ca3845f49a706880cd1e22a2c8f91f511da63b62bab4fb3decce67a37.978384e4.png","excerpt":"At Redocly, we embrace developer experience. We believe docs-as-code is the optimal developer experience for producers of APIs.","slug":"/blog/docs-as-code"},{"template":"../@theme/templates/BlogPost","title":"From ReDoc to Redoc.ly","seo":{"title":"From ReDoc to Redoc.ly"},"author":{"id":"roman-hotsiy","name":"Roman Hotsiy","authorBIO":"CTO and Founder, Redocly","image":"/assets/roman.f8898bfe764099b1e94326b0f69dc6af33d948811a4416ba66dae591385c27c7.978384e4.png"},"publishedDate":"2019-11-08","categories":[{"category":{"id":"redocly","label":"Redocly"},"subcategory":{"id":"redoc","label":"Redoc"}}],"image":"/assets/blog-4.0af53f67bae20fdd71bf8ec44eaae581e89c61aac08698e938a3af915ac6a550.978384e4.jpg","excerpt":"As you probably know ReDoc was developed by Rebilly which is a payment/subscription company. Their main product is an API and it has a lot of endpoints and advanced payloads.","slug":"/blog/from-redoc-to-redocly"},{"template":"../@theme/templates/BlogPost","title":"OpenAPI 3","seo":{"title":"OpenAPI 3"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2019-01-09","categories":[{"category":{"id":"api-specifications","label":"API specifications"},"subcategory":{"id":"openapi","label":"OpenAPI"}}],"image":"/assets/blog-3.c26d097611c588131504f7695580f95d3d0f2b90c44c96877d7c906a097b900c.978384e4.png","slug":"/blog/openapi-3"},{"template":"../@theme/templates/BlogPost","title":"API-first design","seo":{"title":"API-first design"},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2018-05-06","categories":[{"category":{"id":"api-lifecycle","label":"API lifecycle"},"subcategory":{"id":"design","label":"Design"}}],"image":"/assets/blog-2.d88e9d96c48ac2aefdcbd45f89bcb9ff9b6e0a0dc494757bfe7d44868c726726.978384e4.png","slug":"/blog/api-first"},{"template":"../@theme/templates/BlogPost","title":"Hello world, our mission is to perfect the API Developer Portal","description":"ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs.","seo":{"title":"Hello world, our mission is to perfect the API Developer Portal","description":"ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs."},"author":{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"/assets/adam.9f600e56390be1ff1f9a53f82c7724d070e1944836fb1a8dc524afd229219b49.978384e4.png"},"publishedDate":"2018-05-05","categories":[{"category":{"id":"developer-portal","label":"Developer portal"}}],"image":"/assets/blog-1.753b471e3972ae806c366fa4121f910f01d36e9db9352df290c7446c8528c7ba.978384e4.png","slug":"/blog/api-dev-portal"}],"metadata":{"authors":[{"id":"adam-altman","name":"Adam Altman","authorBIO":"CEO and Founder, Redocly","image":"adam.png"},{"id":"mada-namtla","name":"Mada Namtla","image":"mada.png"},{"id":"roman-hotsiy","name":"Roman Hotsiy","authorBIO":"CTO and Founder, Redocly","image":"roman.png"},{"id":"namor-yistoh","name":"Namor Yistoh","image":"namor.png"},{"id":"swapnil-ogale","name":"Swapnil Ogale","image":"swapnil.png"},{"id":"ivana-devcic","name":"Ivana Isadora Devcic","authorBIO":"Technical Writer, Redocly","image":"ivana.png"},{"id":"jody-winter","name":"Jody Winter","image":"jody-winter.png"},{"id":"lorna-mitchell","name":"Lorna Mitchell","authorBIO":"Redocly VP of Developer Experience, OpenAPI Technical Steering Committee member","image":"lorna.png"},{"id":"heather-cloward","name":"Heather Cloward","authorBIO":"Technical Writer, Redocly","image":"heather.png"},{"id":"taylor-krusen","name":"Taylor Krusen","authorBIO":"Developer Experience Engineer, Redocly","image":"taylor-cartoon-headshot.png"},{"id":"matt-williams","name":"Matt Williams","authorBIO":"SVP of Marketing, Redocly","image":"matt-williams.png"},{"id":"ivan-kropyvnytskyi","name":"Ivan Kropyvnytskyi","authorBIO":"Software Engineer, Redocly","image":"ivan.png"},{"id":"roman-marshevskyi","name":"Roman Marshevskyi","authorBIO":"Director of Engineering, Redocly","image":"marshevskyi.png"},{"id":"dmytro-ananskyi","name":"Dmytro Ananskyi","authorBIO":"Software Engineer, Redocly","image":"ananskyi.png"},{"id":"vitalii-skulskyi","name":"Vitalii Skulskyi","authorBIO":"Software Engineer, Redocly","image":"skulskyi.jpg"},{"id":"adam-sobaniec","name":"Adam Sobaniec","authorBIO":"Software Engineer, Redocly","image":"sobaniec.png"}],"categories":[{"id":"api-catalog","label":"API catalog","subcategories":[{"id":"discovery","label":"Discovery"},{"id":"entity-automation","label":"Entity automation"},{"id":"scorecards","label":"Scorecards"},{"id":"service-ownership","label":"Service ownership"},{"id":"dependency-maps","label":"Dependency maps"}]},{"id":"api-documentation","label":"API documentation","subcategories":[{"id":"api-seo","label":"API SEO"},{"id":"reference-docs","label":"Reference docs"},{"id":"tutorials-guides","label":"Tutorials & guides"},{"id":"versioning-comms","label":"Versioning communication"},{"id":"documentation-strategy","label":"Documentation strategy"}]},{"id":"api-governance","label":"API governance","subcategories":[{"id":"linting-rulesets","label":"Linting & rulesets"},{"id":"breaking-changes","label":"Breaking changes"},{"id":"review-workflows","label":"Review workflows"},{"id":"lifecycle-gates","label":"Lifecycle gates"},{"id":"compliance-quality","label":"Compliance & quality"}]},{"id":"api-lifecycle","label":"API lifecycle","subcategories":[{"id":"design","label":"Design"},{"id":"mocking","label":"Mocking"},{"id":"release-management","label":"Release management"},{"id":"deprecation-sunsetting","label":"Deprecation & sunsetting"}]},{"id":"api-monitoring","label":"API monitoring","subcategories":[{"id":"synthetic-monitoring","label":"Synthetic monitoring"},{"id":"workflow-monitoring","label":"Workflow monitoring"},{"id":"performance-metrics","label":"Performance metrics"}]},{"id":"api-specifications","label":"API specifications","subcategories":[{"id":"openapi","label":"OpenAPI"},{"id":"arazzo","label":"Arazzo"},{"id":"asyncapi","label":"AsyncAPI"},{"id":"json-schema","label":"JSON Schema"},{"id":"graphql-sdl","label":"GraphQL SDL"},{"id":"contract-patterns","label":"Contract patterns"},{"id":"modeling-best-practices","label":"Modeling best practices"}]},{"id":"api-testing","label":"API testing","subcategories":[{"id":"contract-testing","label":"Contract testing"},{"id":"integration-testing","label":"Integration testing"},{"id":"mock-servers","label":"Mock servers"},{"id":"workflow-testing","label":"Workflow testing"}]},{"id":"api-versioning","label":"API versioning","subcategories":[{"id":"semantic-versioning","label":"Semantic versioning"},{"id":"design-time-versioning","label":"Design-time versioning"},{"id":"runtime-compatibility","label":"Runtime compatibility"},{"id":"migrations","label":"Migrations"}]},{"id":"developer-portal","label":"Developer portal","subcategories":[{"id":"information-architecture","label":"Information architecture"},{"id":"navigation-patterns","label":"Navigation patterns"},{"id":"search","label":"Search"},{"id":"branding-theming","label":"Branding & theming"},{"id":"multi-product-experiences","label":"Multi-product experiences"}]},{"id":"docs-as-code","label":"Docs-as-code","subcategories":[{"id":"content-reuse","label":"Content reuse"},{"id":"variables-includes","label":"Variables & includes"},{"id":"git-workflows","label":"Git workflows"},{"id":"preview-environments","label":"Preview environments"}]},{"id":"internal-developer-portal","label":"Internal developer portal","subcategories":[{"id":"service-catalog","label":"Service catalog"},{"id":"golden-paths","label":"Golden paths"},{"id":"scorecards-idp","label":"Scorecards"},{"id":"governance-signals","label":"Governance signals"},{"id":"dependency-maps-idp","label":"Dependency maps"}]},{"id":"redocly","label":"Redocly","subcategories":[{"id":"redoc","label":"Redoc"},{"id":"redocly-cli","label":"Redocly CLI"},{"id":"recheck","label":"Recheck"},{"id":"realm","label":"Realm"},{"id":"reef","label":"Reef"},{"id":"reunite","label":"Reunite"},{"id":"pricing-usage","label":"Pricing & usage"},{"id":"product-updates","label":"Product updates"}]},{"id":"technical-documentation","label":"Technical documentation","subcategories":[{"id":"conceptual-documentation","label":"Conceptual documentation"},{"id":"tutorials-onboarding","label":"Tutorials & onboarding"},{"id":"information-architecture-td","label":"Information architecture"},{"id":"writing-style","label":"Writing style"},{"id":"docs-ux","label":"Documentation UX"},{"id":"ai-assisted-docs","label":"AI-assisted documentation"}]}]}}