Skip to content

Commit e661b22

Browse files
committed
Upgrade to Docusaurus 3.10
1 parent f97d764 commit e661b22

3 files changed

Lines changed: 503 additions & 568 deletions

File tree

docusaurus.config.js

Lines changed: 45 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,21 @@ export default async function createAsyncConfig() {
1515
/** @type {import('@docusaurus/types').Config} */
1616
const config = {
1717
future: {
18-
experimental_faster: {
18+
v4: {
19+
removeLegacyPostBuildHeadAttribute: true,
20+
useCssCascadeLayers: true,
21+
siteStorageNamespacing: true,
22+
fasterByDefault: true,
23+
mdx1CompatDisabledByDefault: true,
24+
},
25+
faster: {
1926
swcJsLoader: true,
2027
swcJsMinimizer: true,
2128
swcHtmlMinimizer: true,
2229
lightningCssMinimizer: true,
2330
rspackBundler: true,
2431
rspackPersistentCache: true,
32+
ssgWorkerThreads: true,
2533
mdxCrossCompilerCache: true,
2634
},
2735
},
@@ -35,7 +43,7 @@ export default async function createAsyncConfig() {
3543
markdown: {
3644
hooks: {
3745
onBrokenMarkdownLinks: 'throw',
38-
}
46+
},
3947
},
4048

4149
// Even if you don't use internalization, you can use this field to set useful
@@ -62,9 +70,9 @@ export default async function createAsyncConfig() {
6270
'data-modal-header-bg-color': '#FFFFFF',
6371
'data-user-analytics-fingerprint-enabled': 'true',
6472
'data-user-analytics-store-ip': 'true',
65-
'data-mcp-enabled': "true",
66-
'data-mcp-server-url': "https://calico-docs.mcp.kapa.ai",
67-
'data-mcp-button-text': "MCP",
73+
'data-mcp-enabled': 'true',
74+
'data-mcp-server-url': 'https://calico-docs.mcp.kapa.ai',
75+
'data-mcp-button-text': 'MCP',
6876
async: true,
6977
},
7078
],
@@ -123,10 +131,11 @@ export default async function createAsyncConfig() {
123131
searchPagePath: '/search',
124132
},
125133
announcementBar: {
126-
id: "calico_hackathon_deadline",
127-
content: '🚀 Deadline Extended! (Ends April 30, 2026!) Finalize your GitHub repo and demo video to enter the <a href="https://www.tigera.io/lp/project-calico-hackathon?utm_source=website&utm_medium=docs_site&utm_campaign=Hackathon2026">Calico 3.30+ Hackathon.</a>',
128-
backgroundColor: "#FCE181",
129-
textColor: "#000",
134+
id: 'calico_hackathon_deadline',
135+
content:
136+
'🚀 Deadline Extended! (Ends April 30, 2026!) Finalize your GitHub repo and demo video to enter the <a href="https://www.tigera.io/lp/project-calico-hackathon?utm_source=website&utm_medium=docs_site&utm_campaign=Hackathon2026">Calico 3.30+ Hackathon.</a>',
137+
backgroundColor: '#FCE181',
138+
textColor: '#000',
130139
isCloseable: true,
131140
},
132141
navbar: {
@@ -410,15 +419,15 @@ export default async function createAsyncConfig() {
410419
path: 'calico',
411420
routeBasePath: 'calico',
412421
editCurrentVersion: true,
413-
onlyIncludeVersions: [...nextVersion, '3.31','3.30','3.29'],
422+
onlyIncludeVersions: [...nextVersion, '3.31', '3.30', '3.29'],
414423
lastVersion: '3.31',
415424
versions: {
416425
current: {
417426
label: 'Next',
418427
path: 'next',
419428
banner: 'unreleased',
420429
},
421-
'3.31': {
430+
3.31: {
422431
label: '3.31 (latest)',
423432
path: 'latest',
424433
banner: 'none',
@@ -447,7 +456,7 @@ export default async function createAsyncConfig() {
447456
path: 'calico-enterprise',
448457
routeBasePath: 'calico-enterprise',
449458
editCurrentVersion: true,
450-
onlyIncludeVersions: [...nextVersion, '3.23-1','3.22-2','3.21-2','3.20-2'],
459+
onlyIncludeVersions: [...nextVersion, '3.23-1', '3.22-2', '3.21-2', '3.20-2'],
451460
lastVersion: '3.22-2',
452461
versions: {
453462
current: {
@@ -526,27 +535,31 @@ export default async function createAsyncConfig() {
526535
editUrl: generateEditUrl,
527536
},
528537
],
529-
['./src/plugins/docusaurus-plugin-llms-txt', {
530-
siteDescription: 'Calico documentation for networking, network security, and observability for Kubernetes, including Calico Open Source, Calico Enterprise, and Calico Cloud.',
531-
productDescriptions: {
532-
'calico': 'Open source networking and network security for containers and Kubernetes.',
533-
'calico-enterprise': 'Enterprise-grade networking, security, and observability for Kubernetes.',
534-
'calico-cloud': 'SaaS-based Kubernetes security and observability platform.',
538+
[
539+
'./src/plugins/docusaurus-plugin-llms-txt',
540+
{
541+
siteDescription:
542+
'Calico documentation for networking, network security, and observability for Kubernetes, including Calico Open Source, Calico Enterprise, and Calico Cloud.',
543+
productDescriptions: {
544+
calico: 'Open source networking and network security for containers and Kubernetes.',
545+
'calico-enterprise': 'Enterprise-grade networking, security, and observability for Kubernetes.',
546+
'calico-cloud': 'SaaS-based Kubernetes security and observability platform.',
547+
},
548+
topPages: [
549+
'/calico/latest/getting-started/kubernetes/quickstart',
550+
'/calico-enterprise/latest/getting-started/install-on-clusters/kubernetes/quickstart',
551+
'/calico-cloud/get-started/connect-cluster',
552+
'/calico/latest/networking/determine-best-networking',
553+
'/calico/latest/network-policy/get-started/calico-policy/calico-network-policy',
554+
'/calico-enterprise/latest/network-policy/policy-tiers/tiered-policy',
555+
'/calico/latest/operations/ebpf/enabling-ebpf',
556+
'/calico-enterprise/latest/observability',
557+
'/calico/latest/networking/configuring/bgp',
558+
'/calico-cloud/get-started/system-requirements',
559+
],
560+
optionalSections: ['release notes'],
535561
},
536-
topPages: [
537-
'/calico/latest/getting-started/kubernetes/quickstart',
538-
'/calico-enterprise/latest/getting-started/install-on-clusters/kubernetes/quickstart',
539-
'/calico-cloud/get-started/connect-cluster',
540-
'/calico/latest/networking/determine-best-networking',
541-
'/calico/latest/network-policy/get-started/calico-policy/calico-network-policy',
542-
'/calico-enterprise/latest/network-policy/policy-tiers/tiered-policy',
543-
'/calico/latest/operations/ebpf/enabling-ebpf',
544-
'/calico-enterprise/latest/observability',
545-
'/calico/latest/networking/configuring/bgp',
546-
'/calico-cloud/get-started/system-requirements',
547-
],
548-
optionalSections: ['release notes'],
549-
}],
562+
],
550563
],
551564
customFields: {
552565
isTesting: process.env.TESTING || false,

package.json

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,12 @@
3737
"@chakra-ui/theme-tools": "2.2.6",
3838
"@crawlee/utils": "^3.13.10",
3939
"@docsearch/react": "^3.9.0",
40-
"@docusaurus/core": "^3.9.2",
41-
"@docusaurus/faster": "^3.9.2",
42-
"@docusaurus/plugin-content-docs": "^3.9.2",
43-
"@docusaurus/preset-classic": "^3.9.2",
44-
"@docusaurus/theme-common": "^3.9.2",
45-
"@docusaurus/theme-search-algolia": "^3.9.2",
40+
"@docusaurus/core": "^3.10.0",
41+
"@docusaurus/faster": "^3.10.0",
42+
"@docusaurus/plugin-content-docs": "^3.10.0",
43+
"@docusaurus/preset-classic": "^3.10.0",
44+
"@docusaurus/theme-common": "^3.10.0",
45+
"@docusaurus/theme-search-algolia": "^3.10.0",
4646
"@emotion/react": "^11.9.3",
4747
"@emotion/styled": "^11.9.3",
4848
"@jest/globals": "^29.4.1",
@@ -67,9 +67,9 @@
6767
"unist-util-visit": "^5.0.0"
6868
},
6969
"devDependencies": {
70-
"@docusaurus/module-type-aliases": "^3.9.2",
71-
"@docusaurus/tsconfig": "^3.9.2",
72-
"@docusaurus/types": "^3.9.2",
70+
"@docusaurus/module-type-aliases": "^3.10.0",
71+
"@docusaurus/tsconfig": "^3.10.0",
72+
"@docusaurus/types": "^3.10.0",
7373
"@playwright/test": "1.47.2",
7474
"@testing-library/dom": "^10.4.1",
7575
"@testing-library/jest-dom": "^6.6.4",

0 commit comments

Comments
 (0)