From 5d07cd6e4912cfaa0f5860b9e14703893feff6b0 Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Mon, 19 Jan 2026 12:00:21 +0200 Subject: [PATCH 1/6] chore: add get started guide cards --- docs/images/rocket-icon.svg | 6 ++++ docs/index.md | 12 +++++++ pages/learning-center/cards.ts | 32 ++++++++++++++----- .../images/get-started-thumbnail.svg | 9 ++++++ 4 files changed, 51 insertions(+), 8 deletions(-) create mode 100644 docs/images/rocket-icon.svg create mode 100644 pages/learning-center/images/get-started-thumbnail.svg diff --git a/docs/images/rocket-icon.svg b/docs/images/rocket-icon.svg new file mode 100644 index 00000000..460f1298 --- /dev/null +++ b/docs/images/rocket-icon.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/docs/index.md b/docs/index.md index 0d7253cb..db7f6d61 100644 --- a/docs/index.md +++ b/docs/index.md @@ -8,6 +8,18 @@ seo: Welcome to the official Redocly Documentation. Ready to build something amazing? +{% cards %} + {% card + title="Get started guide" + layout="horizontal" + align="start" + to="/docs/realm/get-started/index.md" + icon="./images/rocket-icon.svg" + %} + Go live with your docs in minutes using our guided setup + {% /card %} +{% /cards %} + ## Products {% cards columns=2 cardMinWidth=300 %} diff --git a/pages/learning-center/cards.ts b/pages/learning-center/cards.ts index a6a62080..6e184b57 100644 --- a/pages/learning-center/cards.ts +++ b/pages/learning-center/cards.ts @@ -5,10 +5,26 @@ import apiTestingThumbnail from './images/api-testing-thumbnail.svg'; import apiSecurityThumbnail from './images/api-security-thumbnail.svg'; import arazzoThumbnail from './images/arazzo-thumbnail.svg'; import aiForDocsThumbnail from './images/ai-for-docs-thumbnail.svg'; +import getStartedThumbnail from './images/get-started-thumbnail.svg'; export const cards = [ { id: 1, + key: 'get-started', + title: 'Get started', + description: 'Everything you need to build, validate, and ship great API documentation.', + thumbnail: getStartedThumbnail, + moreItems: '', + landingPage: '/learn/openapi/learning-openapi', + items: [ + { title: 'Get started with the Reunite editor', link: '/docs/realm/get-started/start-reunite-editor' }, + { title: 'Start with local development', link: '/docs/realm/get-started/start-local-dev' }, + { title: 'Migrate from legacy', link: '/docs/realm/get-started/migrate-api-reference' }, + { title: 'Upgrade product version', link: '/docs/realm/get-started/upgrade-realm-version' }, + ], + }, + { + id: 2, key: 'open-api', title: 'OpenAPI', description: 'Resources for learning more about OpenAPI and how to use it.', @@ -23,7 +39,7 @@ export const cards = [ ], }, { - id: 2, + id: 3, key: 'arazzo', title: 'Arazzo', description: @@ -39,7 +55,7 @@ export const cards = [ ], }, { - id: 3, + id: 4, key: 'markdoc', title: 'Markdoc', description: 'Next-generation markup resources and detailed tag library.', @@ -54,7 +70,7 @@ export const cards = [ ], }, { - id: 4, + id: 5, key: 'yaml', title: 'YAML', description: 'Learn how to use YAML in your API documentation and configuration.', @@ -69,7 +85,7 @@ export const cards = [ ], }, // { - // id: 5, + // id: 6, // key: 'api-governance', // title: 'API governance', // description: 'Use our interactive tool to build linting rules for your API.', @@ -84,7 +100,7 @@ export const cards = [ // ], // }, { - id: 5, + id: 6, key: 'api-testing', title: 'API Testing', description: @@ -98,7 +114,7 @@ export const cards = [ ], }, { - id: 6, + id: 7, key: 'api-security', title: 'API Security', description: @@ -115,7 +131,7 @@ export const cards = [ ], }, { - id: 7, + id: 8, key: 'ai-for-docs', title: 'AI for Docs', description: @@ -130,7 +146,7 @@ export const cards = [ ], }, // { - // id: 8, + // id: 9, // key: 'graphql', // title: 'GraphQL', // description: diff --git a/pages/learning-center/images/get-started-thumbnail.svg b/pages/learning-center/images/get-started-thumbnail.svg new file mode 100644 index 00000000..7803fdbf --- /dev/null +++ b/pages/learning-center/images/get-started-thumbnail.svg @@ -0,0 +1,9 @@ + + + + + + + + + From 1cef9bf9e27e17087d1d896513dec7913e3501b7 Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Mon, 19 Jan 2026 12:09:20 +0200 Subject: [PATCH 2/6] fix: remove trailing space --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index db7f6d61..2800c764 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,7 +11,7 @@ Ready to build something amazing? {% cards %} {% card title="Get started guide" - layout="horizontal" + layout="horizontal" align="start" to="/docs/realm/get-started/index.md" icon="./images/rocket-icon.svg" From 3b16c23e33f0f93e8b4fd2cac80076b0aea0f812 Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Tue, 20 Jan 2026 11:04:26 +0200 Subject: [PATCH 3/6] chore: update marketing-pages version --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index e009c98b..bffa4914 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,7 +9,7 @@ "version": "1.0.0", "license": "UNLICENSED", "dependencies": { - "@redocly/marketing-pages": "0.1.44", + "@redocly/marketing-pages": "0.1.45", "@redocly/realm": "0.129.0-next.2", "buffer": "^6.0.3", "highlight-words-core": "^1.2.3", @@ -3458,9 +3458,9 @@ "license": "SEE LICENSE IN LICENSE" }, "node_modules/@redocly/marketing-pages": { - "version": "0.1.44", - "resolved": "https://registry.npmjs.org/@redocly/marketing-pages/-/marketing-pages-0.1.44.tgz", - "integrity": "sha512-7yF1Xj0Jc+1vGxP67ebGEvWcxragzl/K5YrHME906Ph+FtfrytvgQPtI9dBYCuEy4dDmjggvpfUM/H/20OtkTQ==", + "version": "0.1.45", + "resolved": "https://registry.npmjs.org/@redocly/marketing-pages/-/marketing-pages-0.1.45.tgz", + "integrity": "sha512-ibkElBEkcH1hWRcHQ4rxpsVvVrG1FG6kyadWHHp0QD0BVoUeRRNIgA3NbYI35rOuf1Ed8NfLNSktAGhZMskKuQ==", "license": "UNLICENSED", "dependencies": { "@codemirror/lang-json": "^6.0.1", diff --git a/package.json b/package.json index 503665fc..cdd12aa4 100644 --- a/package.json +++ b/package.json @@ -13,7 +13,7 @@ "author": "team@redocly.com", "license": "UNLICENSED", "dependencies": { - "@redocly/marketing-pages": "0.1.44", + "@redocly/marketing-pages": "0.1.45", "@redocly/realm": "0.129.0-next.2", "buffer": "^6.0.3", "highlight-words-core": "^1.2.3", From e9a6c9f02eb712802f692e0efa33e70b6a52133a Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Tue, 20 Jan 2026 20:31:02 +0200 Subject: [PATCH 4/6] chore: update rocket icon and cards --- @theme/styles.css | 12 ++++++++++++ docs/images/rocket-icon.svg | 8 +++----- docs/index.md | 1 + pages/learning-center/cards.ts | 14 +++++++------- 4 files changed, 23 insertions(+), 12 deletions(-) diff --git a/@theme/styles.css b/@theme/styles.css index b9ea2c76..781f10a6 100644 --- a/@theme/styles.css +++ b/@theme/styles.css @@ -732,6 +732,18 @@ } } +[className="rocket-icon"] { + path { + fill: #1A1C21; + } +} + +.dark [className="rocket-icon"] { + path { + fill: #FBFBFC; + } +} + tr td:first-child code { word-break: normal; } diff --git a/docs/images/rocket-icon.svg b/docs/images/rocket-icon.svg index 460f1298..0c5dd614 100644 --- a/docs/images/rocket-icon.svg +++ b/docs/images/rocket-icon.svg @@ -1,6 +1,4 @@ - - - - - + + + diff --git a/docs/index.md b/docs/index.md index 2800c764..c176e865 100644 --- a/docs/index.md +++ b/docs/index.md @@ -15,6 +15,7 @@ Ready to build something amazing? align="start" to="/docs/realm/get-started/index.md" icon="./images/rocket-icon.svg" + iconVariant="filled" %} Go live with your docs in minutes using our guided setup {% /card %} diff --git a/pages/learning-center/cards.ts b/pages/learning-center/cards.ts index 6e184b57..80b0c2d7 100644 --- a/pages/learning-center/cards.ts +++ b/pages/learning-center/cards.ts @@ -26,7 +26,7 @@ export const cards = [ { id: 2, key: 'open-api', - title: 'OpenAPI', + title: 'Learn OpenAPI', description: 'Resources for learning more about OpenAPI and how to use it.', thumbnail: openApiThumbnail, moreItems: '40 more topics', @@ -41,7 +41,7 @@ export const cards = [ { id: 3, key: 'arazzo', - title: 'Arazzo', + title: 'Learn Arazzo', description: 'Learn how to use Arazzo to describe practical API workflows.', thumbnail: arazzoThumbnail, @@ -57,7 +57,7 @@ export const cards = [ { id: 4, key: 'markdoc', - title: 'Markdoc', + title: 'Learn Markdoc', description: 'Next-generation markup resources and detailed tag library.', thumbnail: markdocThumbnail, moreItems: '11 more topics', @@ -72,7 +72,7 @@ export const cards = [ { id: 5, key: 'yaml', - title: 'YAML', + title: 'Learn YAML', description: 'Learn how to use YAML in your API documentation and configuration.', thumbnail: yamlThumbnail, moreItems: '4 more topics', @@ -102,7 +102,7 @@ export const cards = [ { id: 6, key: 'api-testing', - title: 'API Testing', + title: 'Learn API Testing', description: 'Master API testing fundamentals with tools, techniques, and best practices.', thumbnail: apiTestingThumbnail, @@ -116,7 +116,7 @@ export const cards = [ { id: 7, key: 'api-security', - title: 'API Security', + title: 'Learn API Security', description: 'Gain insights into securing your APIs with essential resources, tools, and best practices to protect your applications.', thumbnail: apiSecurityThumbnail, @@ -133,7 +133,7 @@ export const cards = [ { id: 8, key: 'ai-for-docs', - title: 'AI for Docs', + title: 'Learn AI for Docs', description: 'Learn how to use AI to improve your API documentation.', thumbnail: aiForDocsThumbnail, From 3d435e3d5c6e2da1929496bd1a1d6ed8cab6d3a5 Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Tue, 20 Jan 2026 22:35:24 +0200 Subject: [PATCH 5/6] chore: upgrade marketing-pages version --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index bffa4914..1947281a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,7 +9,7 @@ "version": "1.0.0", "license": "UNLICENSED", "dependencies": { - "@redocly/marketing-pages": "0.1.45", + "@redocly/marketing-pages": "0.1.46", "@redocly/realm": "0.129.0-next.2", "buffer": "^6.0.3", "highlight-words-core": "^1.2.3", @@ -3458,9 +3458,9 @@ "license": "SEE LICENSE IN LICENSE" }, "node_modules/@redocly/marketing-pages": { - "version": "0.1.45", - "resolved": "https://registry.npmjs.org/@redocly/marketing-pages/-/marketing-pages-0.1.45.tgz", - "integrity": "sha512-ibkElBEkcH1hWRcHQ4rxpsVvVrG1FG6kyadWHHp0QD0BVoUeRRNIgA3NbYI35rOuf1Ed8NfLNSktAGhZMskKuQ==", + "version": "0.1.46", + "resolved": "https://registry.npmjs.org/@redocly/marketing-pages/-/marketing-pages-0.1.46.tgz", + "integrity": "sha512-dNUw+/FAzfKtJ13axzjia8ur22lecRN6G98BHK1LSCrj2e8PtditRHvN8iZnDIZBjJNtnuAYrptJljrowndUvw==", "license": "UNLICENSED", "dependencies": { "@codemirror/lang-json": "^6.0.1", diff --git a/package.json b/package.json index cdd12aa4..bf595438 100644 --- a/package.json +++ b/package.json @@ -13,7 +13,7 @@ "author": "team@redocly.com", "license": "UNLICENSED", "dependencies": { - "@redocly/marketing-pages": "0.1.45", + "@redocly/marketing-pages": "0.1.46", "@redocly/realm": "0.129.0-next.2", "buffer": "^6.0.3", "highlight-words-core": "^1.2.3", From 10de3f2e8a1c36d9fdca618d1ae31d9c9f417ae2 Mon Sep 17 00:00:00 2001 From: Daryna Pastushenko Date: Tue, 20 Jan 2026 22:57:15 +0200 Subject: [PATCH 6/6] chore: update icon --- docs/images/rocket-icon.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/images/rocket-icon.svg b/docs/images/rocket-icon.svg index 0c5dd614..53397b43 100644 --- a/docs/images/rocket-icon.svg +++ b/docs/images/rocket-icon.svg @@ -1,4 +1,4 @@ - +