docs(turbopack): conslidate existing links (vercel#62034)

### What?

This PR improves turbopack documentation, mostly collects existing
documents into a single place.

Also, adds a support to render mermaid diagram.

Closes PACK-2488

.eslintignore

@@ -38,3 +38,4 @@ bench/nested-deps-app-router/**
 packages/next-bundle-analyzer/index.d.ts
 examples/with-typescript-graphql/lib/gql/
 test/development/basic/hmr/components/parse-error.js
+packages/next-swc/docs/assets/**/*

.github/workflows/build_and_deploy.yml

@@ -490,7 +490,14 @@ jobs:
         uses: peaceiris/actions-mdbook@v1
         with:
           mdbook-version: 'latest'
+      - name: Install cargo-binstall
+        uses: cargo-bins/[email protected]
+
       - uses: Swatinem/rust-cache@v2
+
+      - run: |
+          cargo binstall mdbook-mermaid --no-confirm
+
       - name: Deploy preview docs
         if: ${{ needs.build.outputs.isRelease != 'true' }}
         run: ./scripts/deploy-turbopack-docs.sh

.github/workflows/build_and_test.yml

@@ -148,7 +148,7 @@ jobs:
       needsRust: 'yes'
       skipInstallBuild: 'yes'
       skipNativeBuild: 'yes'
-      afterBuild: ./scripts/deploy-turbopack-docs.sh
+      afterBuild: cargo binstall mdbook-mermaid --no-confirm && ./scripts/deploy-turbopack-docs.sh
       stepName: 'rust-doc-check'
     secrets: inherit
 

.github/workflows/build_reusable.yml

@@ -114,6 +114,9 @@ jobs:
         with:
           mdbook-version: 'latest'
 
+      - name: Install cargo-binstall
+        uses: cargo-bins/[email protected]
+
       - name: 'Install mold linker'
         if: ${{ inputs.mold == 'yes' }}
         run: |

.prettierignore

@@ -20,6 +20,7 @@ packages/next/src/bundles/webpack/packages/lazy-compilation-*.js
 packages/next-swc/crates/**/tests/**/output*
 packages/next-swc/crates/core/tests/loader/issue-32553/input.js
 packages/next-swc/native/**/*
+packages/next-swc/docs/assets/**/*
 
 packages/next-codemod/transforms/__testfixtures__/**
 packages/next-codemod/transforms/__tests__/**

packages/next-swc/docs/assets/mermaid-init.js

@@ -0,0 +1 @@
+mermaid.initialize({ startOnLoad: true })