From d3b3aaa4ac7a57031dad737360f6ab8fcb37b3c0 Mon Sep 17 00:00:00 2001
From: Massoud Maboudi <massoud.maboudi@gmail.com>
Date: Sun, 21 Feb 2021 13:03:59 +0330
Subject: [PATCH 1/8] added more details about --danger flag for swizzle

---
 website/docs/cli.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/website/docs/cli.md b/website/docs/cli.md
index bc53f24ed028..4325517a63f4 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -114,6 +114,18 @@ Running the command will copy the relevant theme files to your site folder. You
 | `--danger`         | Allow swizzling of unstable components |
 | `--typescript`     | Swizzle TypeScript components          |
 
+An example to use `--danger` flag let's consider the below code:
+
+```bash
+npx docusaurus swizzle @docusaurus/theme-classic Logo --danger
+```
+
+:::caution
+
+Unstable Components: components that have a higher risk of breaking changes due to internal refactorings.
+
+:::
+
 To unswizzle a component, simply delete the files of the swizzled component.
 
 <!--

From 061a3cfb6607a71b74be9896895ac2bc80c13b31 Mon Sep 17 00:00:00 2001
From: Massoud Maboudi <massoud.maboudi@gmail.com>
Date: Sun, 21 Feb 2021 13:13:50 +0330
Subject: [PATCH 2/8] added referencing to blog posts

---
 .../guides/docs/docs-markdown-features.mdx    | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/website/docs/guides/docs/docs-markdown-features.mdx b/website/docs/guides/docs/docs-markdown-features.mdx
index 0035a655f29b..e6f2062d6115 100644
--- a/website/docs/guides/docs/docs-markdown-features.mdx
+++ b/website/docs/guides/docs/docs-markdown-features.mdx
@@ -26,3 +26,33 @@ I am referencing a [document](doc1.md). Reference to another [document in a fold
 One benefit of this approach is that the links to external files will still work if you are viewing the file on GitHub.
 
 Another benefit, for versioned docs, is that one versioned doc will link to another doc of the exact same version.
+
+
+## Referencing blog posts
+
+If you want to reference a blog post file, you could use the name of the post you want to reference.
+
+For example, if you are in `folder/doc1.md` and you want to reference `blog/2021-01-02-hello-there.md`:
+
+```md
+---
+title: Hello There
+---
+```
+
+You can add a slug to a blog post in its metadata. Consider another blog post named `blog/2021-01-08-bye-everyone.md`:
+
+```md
+---
+title: Bye Everyone
+slug: bye-everyone
+---
+```
+
+I am referencing a blog post in `../../blog/2021/01/02/hello-there`.
+
+Reference to another blog post with a slug in `../../blog/bye-everyone`.
+
+:::caution Be careful that we should convert the address of the blog post without slug from:
+
+`blog/2021-01-02-hello-there` to `blog/2021/01/02/hello-there` :::
\ No newline at end of file

From cc4a320f0d51133f0faca6291d39f9278d2b5e82 Mon Sep 17 00:00:00 2001
From: Massoud Maboudi <massoud.maboudi@gmail.com>
Date: Mon, 22 Feb 2021 15:15:10 +0330
Subject: [PATCH 3/8] improved the docs for swizzling.

---
 website/docs/cli.md          | 10 +++++-----
 website/docs/using-themes.md |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/website/docs/cli.md b/website/docs/cli.md
index 4325517a63f4..1fa371427611 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -92,18 +92,18 @@ We highly discourage swizzling of components until we've reached a Beta stage. T
 
 :::
 
-Change any Docusaurus theme components to your liking with `docusaurus swizzle`.
+Change any Docusaurus theme components to your liking with `npm run swizzle`.
 
 ```shell
-docusaurus swizzle [themeName] [componentName] [siteDir]
+npm run swizzle [themeName] [componentName] [siteDir]
 
 # Example (leaving out the siteDir to indicate this directory)
-docusaurus swizzle @docusaurus/theme-classic DocSidebar
+npm run swizzle @docusaurus/theme-classic DocSidebar
 ```
 
 Running the command will copy the relevant theme files to your site folder. You may then make any changes to it and Docusaurus will use it instead of the one provided from the theme.
 
-`docusaurus swizzle` without `themeName` lists all the themes available for swizzling similarly `docusaurus swizzle <themeName>` without `componentName` lists all the components available for swizzling.
+`npm run swizzle` without `themeName` lists all the themes available for swizzling similarly `npm run swizzle <themeName>` without `componentName` lists all the components available for swizzling.
 
 #### Options
 
@@ -117,7 +117,7 @@ Running the command will copy the relevant theme files to your site folder. You
 An example to use `--danger` flag let's consider the below code:
 
 ```bash
-npx docusaurus swizzle @docusaurus/theme-classic Logo --danger
+npm run swizzle @docusaurus/theme-classic Logo -- --danger
 ```
 
 :::caution
diff --git a/website/docs/using-themes.md b/website/docs/using-themes.md
index 6bad5c08ecfb..549d2390cad1 100644
--- a/website/docs/using-themes.md
+++ b/website/docs/using-themes.md
@@ -109,7 +109,7 @@ Docusaurus Themes' components are designed to be replaceable. To make it easier
 To swizzle a component for a theme, run the following command in your doc site:
 
 ```shell
-docusaurus swizzle <theme name> [component name]
+npm run swizzle <theme name> [component name]
 ```
 
 As an example, to swizzle the `<Footer />` component in `@docusaurus/theme-classic` for your site, run:

From f2deb4a5e0c7375dda9342631ae4447f7abf862c Mon Sep 17 00:00:00 2001
From: Massoud Maboudi <massoud.maboudi@gmail.com>
Date: Mon, 22 Feb 2021 15:53:29 +0330
Subject: [PATCH 4/8] added new Farsi/Persian translation

---
 .../codeTranslations/fa.json                  | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 packages/docusaurus-theme-classic/codeTranslations/fa.json

diff --git a/packages/docusaurus-theme-classic/codeTranslations/fa.json b/packages/docusaurus-theme-classic/codeTranslations/fa.json
new file mode 100644
index 000000000000..9bbe77b493fa
--- /dev/null
+++ b/packages/docusaurus-theme-classic/codeTranslations/fa.json
@@ -0,0 +1,42 @@
+{
+  "theme.NotFound.title": "صفحه‌ای که دنبال آن بودید پیدا نشد!",
+  "theme.NotFound.p1": "متاسفانه نتوانستیم مطلب مورد نظر شما را پیدا کنیم.",
+  "theme.NotFound.p2": "لطفا با صاحب وبسایت تماس بگیرید و ایشان را از مشکل پیش آمده مطلع کنید.",
+  "theme.AnnouncementBar.closeButtonAriaLabel": "بستن",
+  "theme.blog.paginator.navAriaLabel": "کنترل لیست صفحه وبسایت",
+  "theme.blog.paginator.newerEntries": "مطالب جدیدتر",
+  "theme.blog.paginator.olderEntries": "مطالب قدیمی تر",
+  "theme.blog.post.paginator.navAriaLabel": "کنترل پست های صفحه وبلاگ",
+  "theme.blog.post.paginator.newerPost": "پست های جدید تر",
+  "theme.blog.post.paginator.olderPost": "پست های قدیمی تر",
+  "theme.blog.post.readMore": "ادامه مطلب",
+  "theme.blog.tags": "برچسب ها:",
+  "theme.CodeBlock.copyButtonAriaLabel": "کپی کردن کد به کلیپ بورد",
+  "theme.CodeBlock.copied": "کپی شد",
+  "theme.CodeBlock.copy": "کپی کردن",
+  "theme.docs.paginator.navAriaLabel": "کنترل صفحه اسناد",
+  "theme.docs.paginator.previous": "قبلی",
+  "theme.docs.paginator.next": "بعدی",
+  "theme.docs.sidebar.expandButtonTitle": "بزرگ کردن نوار کناری",
+  "theme.docs.sidebar.expandButtonAriaLabel": "بزرگ کردن نوار کناری",
+  "theme.docs.sidebar.responsiveCloseButtonLabel": "بستن منو",
+  "theme.docs.sidebar.responsiveOpenButtonLabel": "باز کردن منو",
+  "theme.docs.sidebar.collapseButtonTitle": "بستن نوار کناری",
+  "theme.docs.sidebar.collapseButtonAriaLabel": "بستن نوار کناری",
+  "theme.common.editThisPage": "ویرایش صفحه",
+  "theme.common.headingLinkTitle": "لینک مستقیم به عنوان",
+  "theme.common.skipToMainContent": "رفتن به مطلب اصلی",
+  "theme.SearchPage.existingResultsTitle": "جستجو برای عبارت",
+  "theme.SearchPage.emptyResultsTitle": "جستجو در متن",
+  "theme.SearchPage.inputPlaceholder": "عبارت مورد نظر را اینجا بنویسید",
+  "theme.SearchPage.inputLabel": "جستجو",
+  "theme.SearchPage.algoliaLabel": "جستجو با Algolia",
+  "theme.SearchPage.noResultsText": "هیچ نتیجه ای پیدا نشد",
+  "theme.SearchPage.fetchingNewResults": "در حال دریافت نتایج...",
+  "theme.SearchBar.label": "جستجو",
+  "theme.PwaReloadPopup.info": "نسخه جدیدی منتشر شده است",
+  "theme.PwaReloadPopup.refreshButtonText": "بروزرسانی",
+  "theme.PwaReloadPopup.closeButtonAriaLabel": "بستن",
+  "theme.Playground.liveEditor": "ویرایشگر زنده",
+  "theme.Playground.result": "نتایج"
+}

From 73384b6cbb9e13e318357a403a8b04811e1487c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= <slorber@users.noreply.github.com>
Date: Mon, 22 Feb 2021 16:05:20 +0100
Subject: [PATCH 5/8] Update website/docs/cli.md

---
 website/docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/cli.md b/website/docs/cli.md
index 1fa371427611..fe0b6d1ef23e 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -94,7 +94,7 @@ We highly discourage swizzling of components until we've reached a Beta stage. T
 
 Change any Docusaurus theme components to your liking with `npm run swizzle`.
 
-```shell
+```bash npm2yarn
 npm run swizzle [themeName] [componentName] [siteDir]
 
 # Example (leaving out the siteDir to indicate this directory)

From 4056f9bbdb9ff8dbe0db4ff3e583fdb2f7d3a359 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= <slorber@users.noreply.github.com>
Date: Mon, 22 Feb 2021 16:05:51 +0100
Subject: [PATCH 6/8] Update website/docs/cli.md

---
 website/docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/cli.md b/website/docs/cli.md
index fe0b6d1ef23e..8d136b212d3f 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -116,7 +116,7 @@ Running the command will copy the relevant theme files to your site folder. You
 
 An example to use `--danger` flag let's consider the below code:
 
-```bash
+```bash npm2yarn
 npm run swizzle @docusaurus/theme-classic Logo -- --danger
 ```
 

From adc4ffaef414eea0833b9a3078eff25166856965 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= <slorber@users.noreply.github.com>
Date: Mon, 22 Feb 2021 16:06:07 +0100
Subject: [PATCH 7/8] Update website/docs/using-themes.md

---
 website/docs/using-themes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/using-themes.md b/website/docs/using-themes.md
index 549d2390cad1..3ff24ab00251 100644
--- a/website/docs/using-themes.md
+++ b/website/docs/using-themes.md
@@ -108,7 +108,7 @@ Docusaurus Themes' components are designed to be replaceable. To make it easier
 
 To swizzle a component for a theme, run the following command in your doc site:
 
-```shell
+```bash npm2yarn
 npm run swizzle <theme name> [component name]
 ```
 

From 94fc7aa9b8419c33d72b324647bba450fc26dcf6 Mon Sep 17 00:00:00 2001
From: slorber <lorber.sebastien@gmail.com>
Date: Mon, 22 Feb 2021 20:18:10 +0100
Subject: [PATCH 8/8] PR cleanup

---
 .../codeTranslations/fa.json                  | 42 -------------------
 .../guides/docs/docs-markdown-features.mdx    | 30 -------------
 2 files changed, 72 deletions(-)
 delete mode 100644 packages/docusaurus-theme-classic/codeTranslations/fa.json

diff --git a/packages/docusaurus-theme-classic/codeTranslations/fa.json b/packages/docusaurus-theme-classic/codeTranslations/fa.json
deleted file mode 100644
index 9bbe77b493fa..000000000000
--- a/packages/docusaurus-theme-classic/codeTranslations/fa.json
+++ /dev/null
@@ -1,42 +0,0 @@
-{
-  "theme.NotFound.title": "صفحه‌ای که دنبال آن بودید پیدا نشد!",
-  "theme.NotFound.p1": "متاسفانه نتوانستیم مطلب مورد نظر شما را پیدا کنیم.",
-  "theme.NotFound.p2": "لطفا با صاحب وبسایت تماس بگیرید و ایشان را از مشکل پیش آمده مطلع کنید.",
-  "theme.AnnouncementBar.closeButtonAriaLabel": "بستن",
-  "theme.blog.paginator.navAriaLabel": "کنترل لیست صفحه وبسایت",
-  "theme.blog.paginator.newerEntries": "مطالب جدیدتر",
-  "theme.blog.paginator.olderEntries": "مطالب قدیمی تر",
-  "theme.blog.post.paginator.navAriaLabel": "کنترل پست های صفحه وبلاگ",
-  "theme.blog.post.paginator.newerPost": "پست های جدید تر",
-  "theme.blog.post.paginator.olderPost": "پست های قدیمی تر",
-  "theme.blog.post.readMore": "ادامه مطلب",
-  "theme.blog.tags": "برچسب ها:",
-  "theme.CodeBlock.copyButtonAriaLabel": "کپی کردن کد به کلیپ بورد",
-  "theme.CodeBlock.copied": "کپی شد",
-  "theme.CodeBlock.copy": "کپی کردن",
-  "theme.docs.paginator.navAriaLabel": "کنترل صفحه اسناد",
-  "theme.docs.paginator.previous": "قبلی",
-  "theme.docs.paginator.next": "بعدی",
-  "theme.docs.sidebar.expandButtonTitle": "بزرگ کردن نوار کناری",
-  "theme.docs.sidebar.expandButtonAriaLabel": "بزرگ کردن نوار کناری",
-  "theme.docs.sidebar.responsiveCloseButtonLabel": "بستن منو",
-  "theme.docs.sidebar.responsiveOpenButtonLabel": "باز کردن منو",
-  "theme.docs.sidebar.collapseButtonTitle": "بستن نوار کناری",
-  "theme.docs.sidebar.collapseButtonAriaLabel": "بستن نوار کناری",
-  "theme.common.editThisPage": "ویرایش صفحه",
-  "theme.common.headingLinkTitle": "لینک مستقیم به عنوان",
-  "theme.common.skipToMainContent": "رفتن به مطلب اصلی",
-  "theme.SearchPage.existingResultsTitle": "جستجو برای عبارت",
-  "theme.SearchPage.emptyResultsTitle": "جستجو در متن",
-  "theme.SearchPage.inputPlaceholder": "عبارت مورد نظر را اینجا بنویسید",
-  "theme.SearchPage.inputLabel": "جستجو",
-  "theme.SearchPage.algoliaLabel": "جستجو با Algolia",
-  "theme.SearchPage.noResultsText": "هیچ نتیجه ای پیدا نشد",
-  "theme.SearchPage.fetchingNewResults": "در حال دریافت نتایج...",
-  "theme.SearchBar.label": "جستجو",
-  "theme.PwaReloadPopup.info": "نسخه جدیدی منتشر شده است",
-  "theme.PwaReloadPopup.refreshButtonText": "بروزرسانی",
-  "theme.PwaReloadPopup.closeButtonAriaLabel": "بستن",
-  "theme.Playground.liveEditor": "ویرایشگر زنده",
-  "theme.Playground.result": "نتایج"
-}
diff --git a/website/docs/guides/docs/docs-markdown-features.mdx b/website/docs/guides/docs/docs-markdown-features.mdx
index e6f2062d6115..0035a655f29b 100644
--- a/website/docs/guides/docs/docs-markdown-features.mdx
+++ b/website/docs/guides/docs/docs-markdown-features.mdx
@@ -26,33 +26,3 @@ I am referencing a [document](doc1.md). Reference to another [document in a fold
 One benefit of this approach is that the links to external files will still work if you are viewing the file on GitHub.
 
 Another benefit, for versioned docs, is that one versioned doc will link to another doc of the exact same version.
-
-
-## Referencing blog posts
-
-If you want to reference a blog post file, you could use the name of the post you want to reference.
-
-For example, if you are in `folder/doc1.md` and you want to reference `blog/2021-01-02-hello-there.md`:
-
-```md
----
-title: Hello There
----
-```
-
-You can add a slug to a blog post in its metadata. Consider another blog post named `blog/2021-01-08-bye-everyone.md`:
-
-```md
----
-title: Bye Everyone
-slug: bye-everyone
----
-```
-
-I am referencing a blog post in `../../blog/2021/01/02/hello-there`.
-
-Reference to another blog post with a slug in `../../blog/bye-everyone`.
-
-:::caution Be careful that we should convert the address of the blog post without slug from:
-
-`blog/2021-01-02-hello-there` to `blog/2021/01/02/hello-there` :::
\ No newline at end of file