Skip to content

Commit 418a8b1

Browse files
adamaltmanadamaltman
committed
blog: categorize the posts and add blog reorg announcement
1 parent 491c851 commit 418a8b1

File tree

111 files changed

+554
-574
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

111 files changed

+554
-574
lines changed

‎blog/accelerated-learning-openapi.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: Learn OpenAPI in a day
44
description: Accelerated learning approach applied to OpenAPI.
55
seo:
66
title: Learn OpenAPI in a day
77
description: Accelerated learning approach applied to OpenAPI.
88
author: adam-altman
9-
date: 2023-02-21
9+
date: "2023-02-21"
1010
categories:
11-
- openapi
12-
- learning
11+
- api-specifications:openapi
12+
- technical-documentation:tutorials-onboarding
1313
image: team.png
1414
---
1515
## Catalyst

‎blog/add-openapi-tags-for-next-level-api-descriptions.md‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: Add OpenAPI tags for next-level API descriptions
44
description: Tag your OpenAPI endpoints and help your users navigate their own path to success.
55
seo:
66
title: Add OpenAPI tags for next-level API descriptions
77
description: Tag your OpenAPI endpoints and help your users navigate their own path to success.
88
author: lorna-mitchell
9-
date: 2024-03-13
9+
date: "2024-03-13"
1010
categories:
11-
- openapi
12-
- api-design
11+
- api-specifications:openapi
12+
- api-lifecycle:design
1313
image: Redocly_blog_7.jpg
1414
---
15-
1615
Getting to know a new API is always daunting, but for the larger APIs, the hardest part is knowing where to start.
1716
Help users find their way with your API by adding tags to your [OpenAPI](https://www.openapis.org/) [endpoints](https://blog.hubspot.com/website/api-endpoint).
1817

‎blog/all-of-schemas.md‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: How to reuse schemas when required properties change across endpoints
44
description: Answering real questions about how to use OpenAPI to design and describe APIs.
55
seo:
66
title: How to reuse schemas when required properties change across endpoints
77
description: Answering real questions about how to use OpenAPI to design and describe APIs.
88
author: adam-altman
9-
date: 2022-05-04
9+
date: "2022-05-04"
1010
categories:
11-
- openapi
12-
- api-design
11+
- api-specifications:openapi
12+
- api-lifecycle:design
1313
image: team.png
1414
---
15-
1615
# Extending schemas with `allOf`
1716

1817
Question from C-3PO (yes, names and content are changed to protect the innocent):

‎blog/api-catalog-value.md‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: The unseen economics of an API catalog
44
description: Why modern engineering organizations can't operate without one—and how API catalogs deliver measurable ROI through automation, trust, and system visibility.
55
seo:
66
title: The unseen economics of an API catalog | Redocly
77
description: Discover how API catalogs deliver millions in ROI by eliminating search waste, preventing costly mistakes, and enabling faster development through automation and trust.
88
image: ./images/Redocly_blog_8.jpg
99
author: adam-altman
10-
date: 2025-11-17
10+
date: "2025-11-17"
1111
categories:
1212
- api-catalog
1313
image: Redocly_blog_8.jpg
1414
---
15-
1615
# The unseen economics of an API catalog
1716

1817
_Why modern engineering organizations can't operate without one._

‎blog/api-council.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: "API council: the wisdom of your API crowd"
44
description: Invite the stakeholders inside your organization to the table and make your API the best it can be
55
seo:
66
title: "API council: the wisdom of your API crowd"
77
description: Invite the stakeholders inside your organization to the table and make your API the best it can be
88
author: lorna-mitchell
9-
date: 2024-04-17
9+
date: "2024-04-17"
1010
categories:
11-
- openapi
11+
- api-specifications:openapi
1212
image: Redocly_blog_8.jpg
1313
---
14-
1514
API governance is often focused on the creation of standards, and the implementing of those standards using appropriate tooling.
1615
At Redocly, we love API tools so much that that we've built a whole company around building them, but successful API practice is about more than tools.
1716
Like most technology problems, the best solutions lie with the people who are part of the process.

‎blog/api-design-approaches.md‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: Two approaches to API design - Resources vs Workflows
44
description: Exploring resource-first and workflow-first approaches to API design, and why thinking about use cases early can lead to better APIs.
55
seo:
6-
title: "Two approaches to API design - Resources vs Workflows"
6+
title: Two approaches to API design - Resources vs Workflows
77
description: Exploring resource-first and workflow-first approaches to API design, and why thinking about use cases early can lead to better APIs.
88
image: ./images/api-design-approaches.png
99
author: adam-altman
10-
date: 2025-10-28
10+
date: "2025-10-28"
1111
categories:
12-
- api-first
12+
- api-lifecycle:design
1313
image: api-design-approaches.png
1414
---
15-
1615
When designing a new API, there's a fundamental choice that shapes everything that follows: where do you start?
1716
Do you begin by modeling your domain with resources and schemas, or do you start by mapping out the workflows and use cases your API needs to support?
1817

‎blog/api-dev-portal.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: Hello world, our mission is to perfect the API Developer Portal
44
description: ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs.
55
seo:
66
title: Hello world, our mission is to perfect the API Developer Portal
77
description: ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs.
88
author: adam-altman
9-
date: 2018-05-05
9+
date: "2018-05-05"
1010
categories:
11-
- dev-portal
11+
- developer-portal
1212
image: blog-1.png
1313
---
14-
1514
ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs.
1615

1716
Developer documentation is very important to a developer’s experience.

‎blog/api-discovery.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: Presenting multiple APIs for better discovery
44
seo:
55
title: Presenting multiple APIs for better discovery
66
author: adam-altman
7-
date: 2021-01-26
7+
date: "2021-01-26"
88
categories:
9-
- dev-portal
9+
- api-catalog:discovery
1010
image: blog-api-discovery.png
1111
---
1212
Does your organization own documentation for multiple APIs?

‎blog/api-documentation-essentials.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: API documentation essentials
44
description: Discover how great API documentation helps developers succeed and sets your API apart. Learn the essentials of great API docs.
55
seo:
66
title: API documentation essentials
77
description: Discover how great API documentation helps developers succeed and sets your API apart. Learn the essentials of great API docs.
88
author: taylor-krusen
9-
date: 2024-12-15
9+
date: "2024-12-15"
1010
categories:
11-
- api-docs
11+
- api-documentation:reference-docs
1212
image: blog-2.png
1313
---
14-
1514
For companies that offer an API, providing great API documentation makes good business sense.
1615
Developers use API documentation to discover the capabilities of an API and learn to build with it successfully.
1716

‎blog/api-first.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
---
2-
template: '../@theme/templates/BlogPost'
2+
template: ../@theme/templates/BlogPost
33
title: API-first design
44
seo:
55
title: API-first design
66
author: adam-altman
7-
date: 2018-05-06
7+
date: "2018-05-06"
88
categories:
9-
- api-first
9+
- api-lifecycle:design
1010
image: blog-2.png
1111
---
12-
1312
## The background…
1413

1514
By the time ReDoc was released in 2015, I was more comfortable with the OpenAPI (fka Swagger)

0 commit comments

Comments
 (0)