feat: rewrite and complete the migration guide from custom arch (#725)

feature-sliced · Sep 28, 2024 · b68ece7 · b68ece7
1 parent faa602a
commit b68ece7
Show file tree

Hide file tree

Showing 14 changed files with 1,458 additions and 831 deletions.
diff --git a/config/docusaurus/routes.js b/config/docusaurus/routes.js
@@ -10,7 +10,7 @@ const SECTIONS = {
     },
     MIGRATION: {
         shortPath: "/docs/guides/migration",
-        fullPath: "/docs/guides/migration/from-legacy",
+        fullPath: "/docs/guides/migration/from-custom",
     },
 };
 
@@ -249,7 +249,7 @@ const LEGACY_ROUTES = [
             {
                 title: "Migration from Legacy",
                 from: "/docs/guides/migration-from-legacy",
-                to: "/docs/guides/migration/from-legacy",
+                to: "/docs/guides/migration/from-custom",
             },
         ],
     },
@@ -264,6 +264,18 @@ const LEGACY_ROUTES = [
             },
         ],
     },
+    {
+        group: "Rename 'legacy' to 'custom'",
+        details:
+            "'Legacy' is derogatory, we don't get to call people's projects legacy",
+        children: [
+            {
+                title: "Rename 'legacy' to custom",
+                from: "/docs/guides/migration/from-legacy",
+                to: "/docs/guides/migration/from-custom",
+            },
+        ],
+    },
 ];
 
 // @returns { from, to }[]
@@ -314,7 +326,7 @@ const _TOTAL_ROUTES = [
     "/docs/guides/examples/theme",
     "/docs/guides/examples/types",
     "/docs/guides/examples/white-labels",
-    "/docs/guides/migration/from-legacy",
+    "/docs/guides/migration/from-custom",
     "/docs/guides/migration/from-v1",
     "/docs/guides/tech/with-nextjs",
     "/docs/",

diff --git a/i18n/en/docusaurus-plugin-content-docs/current/get-started/overview.mdx b/i18n/en/docusaurus-plugin-content-docs/current/get-started/overview.mdx
@@ -131,7 +131,7 @@ It's advised to refrain from adding new large entities while refactoring or refa
 
 [tutorial]: /docs/get-started/tutorial
 [examples]: /examples
-[migration]: /docs/guides/migration/from-legacy
+[migration]: /docs/guides/migration/from-custom
 [ext-steiger]: https://github.com/feature-sliced/steiger
 [ext-tools]: https://github.com/feature-sliced/awesome?tab=readme-ov-file#tools
 [ext-telegram]: https://t.me/feature_sliced

diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guides/index.mdx b/i18n/en/docusaurus-plugin-content-docs/current/guides/index.mdx
@@ -25,10 +25,10 @@ import { ToolOutlined, ImportOutlined, BugOutlined, FunctionOutlined } from "@an
 />
 <NavCard
     title="Migration" 
-    description="Migration guides for legacy projects"
+    description="Migration guides from other architectures"
     to="/docs/guides/migration/from-v1"
     Icon={ImportOutlined}
-    tags={['From legacy', 'From FSv1']}
+    tags={['From custom architecture', 'From FSv1']}
 />
 <NavCard
     title="Tech" 

diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guides/migration/from-custom.md b/i18n/en/docusaurus-plugin-content-docs/current/guides/migration/from-custom.md
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guides/migration/from-legacy.mdx b/i18n/en/docusaurus-plugin-content-docs/current/guides/migration/from-legacy.mdx
diff --git a/i18n/kr/docusaurus-plugin-content-docs/current/get-started/overview.mdx b/i18n/kr/docusaurus-plugin-content-docs/current/get-started/overview.mdx
@@ -130,7 +130,7 @@ FSD로 마이그레이션하고자 하는 기존 코드베이스가 있다면,
 
 [tutorial]: /docs/get-started/tutorial
 [examples]: /examples
-[migration]: /docs/guides/migration/from-legacy
+[migration]: /docs/guides/migration/from-custom
 [ext-steiger]: https://github.com/feature-sliced/steiger
 [ext-tools]: https://github.com/feature-sliced/awesome?tab=readme-ov-file#tools
 [ext-telegram]: https://t.me/feature_sliced

diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/get-started/overview.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/get-started/overview.mdx
@@ -131,7 +131,7 @@ _\* — эти слои, App и Shared, в отличие от других сл
 
 [tutorial]: /docs/get-started/tutorial
 [examples]: /examples
-[migration]: /docs/guides/migration/from-legacy
+[migration]: /docs/guides/migration/from-custom
 [ext-steiger]: https://github.com/feature-sliced/steiger
 [ext-tools]: https://github.com/feature-sliced/awesome?tab=readme-ov-file#tools
 [ext-telegram]: https://t.me/feature_sliced

diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/index.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/guides/index.mdx
@@ -25,10 +25,10 @@ import { ToolOutlined, ImportOutlined, BugOutlined, FunctionOutlined } from "@an
 />
 <NavCard
     title="Миграция" 
-    description="Гайды по миграции с легаси проектов"
+    description="Гайды по миграции с других архитектур"
     to="/docs/guides/migration/from-v1"
     Icon={ImportOutlined}
-    tags={['Легаси', 'FSv1']}
+    tags={['Кастомная архитектура', 'FSv1']}
 />
 <NavCard
     title="Технологии"