facebook · slorber · Mar 26, 2021 · Feb 15, 2021 · Feb 23, 2021 · Feb 25, 2021
diff --git a/packages/docusaurus-plugin-content-docs/src/props.ts b/packages/docusaurus-plugin-content-docs/src/props.ts
@@ -37,7 +37,7 @@ Available document ids=
 
     return {
       type: 'link',
-      label: sidebarLabel || title,
+      label: sidebarLabel || item.label || title,
       href: permalink,
       customProps: item.customProps,
     };

diff --git a/packages/docusaurus-plugin-content-docs/src/sidebars.ts b/packages/docusaurus-plugin-content-docs/src/sidebars.ts
@@ -118,12 +118,18 @@ function assertIsCategory(
 function assertIsDoc(
   item: Record<string, unknown>,
 ): asserts item is SidebarItemDoc {
-  assertItem(item, ['id', 'customProps']);
+  assertItem(item, ['id', 'label', 'customProps']);
   if (typeof item.id !== 'string') {
     throw new Error(
       `Error loading ${JSON.stringify(item)}. "id" must be a string.`,
     );
   }
+
+  if (item.label && typeof item.label !== 'string') {
+    throw new Error(
+      `Error loading ${JSON.stringify(item)}. "label" must be a string.`,
+    );
+  }
 }
 
 function assertIsLink(

diff --git a/packages/docusaurus-plugin-content-docs/src/types.ts b/packages/docusaurus-plugin-content-docs/src/types.ts
@@ -91,6 +91,7 @@ export type SidebarItemBase = {
 
 export type SidebarItemDoc = SidebarItemBase & {
   type: 'doc' | 'ref';
+  label?: string;
   id: string;
 };
 

diff --git a/website/docs/guides/docs/sidebar.md b/website/docs/guides/docs/sidebar.md
@@ -128,6 +128,7 @@ type SidebarItemDoc =
   | {
       type: 'doc';
       id: string;
+      label: string; // Sidebar label text
     };
 ```
 
@@ -137,10 +138,11 @@ Example:
 {
   type: 'doc',
   id: 'doc1', // string - document id
+  label: 'Getting started' // Sidebar label text
 }
 ```
 
-Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
+The sidebar_label in the markdown frontformatter has a higher precedence over the label key in `SidebarItemDoc`. Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
 
 ```js
 'doc1'; // string - document id

diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx
@@ -1,7 +1,6 @@
 ---
 id: crowdin
 title: i18n - Using Crowdin
-sidebar_label: Using Crowdin
 slug: /i18n/crowdin
 ---
 

diff --git a/website/docs/i18n/i18n-git.md b/website/docs/i18n/i18n-git.md
@@ -1,7 +1,6 @@
 ---
 id: git
 title: i18n - Using git
-sidebar_label: Using Git
 slug: /i18n/git
 ---
 

diff --git a/website/docs/i18n/i18n-introduction.md b/website/docs/i18n/i18n-introduction.md
@@ -1,7 +1,6 @@
 ---
 id: introduction
 title: i18n - Introduction
-sidebar_label: Introduction
 slug: /i18n/introduction
 ---
 

diff --git a/website/docs/i18n/i18n-tutorial.md b/website/docs/i18n/i18n-tutorial.md
@@ -1,7 +1,6 @@
 ---
 id: tutorial
 title: i18n - Tutorial
-sidebar_label: Tutorial
 slug: /i18n/tutorial
 ---
 

diff --git a/website/sidebars.js b/website/sidebars.js
@@ -57,10 +57,26 @@ module.exports = {
           type: 'category',
           label: 'Internationalization',
           items: [
-            'i18n/introduction',
-            'i18n/tutorial',
-            'i18n/git',
-            'i18n/crowdin',
+            {
+              type: 'doc',
+              id: 'i18n/introduction',
+              label: 'Introduction',
+            },
+            {
+              type: 'doc',
+              id: 'i18n/tutorial',
+              label: 'Tutorial',
+            },
+            {
+              type: 'doc',
+              id: 'i18n/git',
+              label: 'Using Git',
+            },
+            {
+              type: 'doc',
+              id: 'i18n/crowdin',
+              label: 'Using Crowdin',
+            },
           ],
         },
       ],

diff --git a/website/versioned_docs/version-2.0.0-alpha.71/guides/docs/sidebar.md b/website/versioned_docs/version-2.0.0-alpha.71/guides/docs/sidebar.md
@@ -128,6 +128,7 @@ type SidebarItemDoc =
   | {
       type: 'doc';
       id: string;
+      label: string; // Sidebar label text
     };
 ```
 
@@ -137,10 +138,11 @@ Example:
 {
   type: 'doc',
   id: 'doc1', // string - document id
+  label: 'Getting started' // Sidebar label text
 }
 ```
 
-Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
+The sidebar_label in the markdown frontformatter has a higher precedence over the label key in `SidebarItemDoc`. Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
 
 ```js
 'doc1'; // string - document id

diff --git a/website/versioned_docs/version-2.0.0-alpha.72/guides/docs/sidebar.md b/website/versioned_docs/version-2.0.0-alpha.72/guides/docs/sidebar.md
@@ -128,6 +128,7 @@ type SidebarItemDoc =
   | {
       type: 'doc';
       id: string;
+      label: string; // Sidebar label text
     };
 ```
 
@@ -137,10 +138,11 @@ Example:
 {
   type: 'doc',
   id: 'doc1', // string - document id
+  label: 'Getting started' // Sidebar label text
 }
 ```
 
-Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
+The sidebar_label in the markdown frontformatter has a higher precedence over the label key in `SidebarItemDoc`. Using just the [Document ID](#document-id) is also valid, the following is equivalent to the above:
 
 ```js
 'doc1'; // string - document id