fix(v2): Fix MDX docs being considered as partials when siteDir match the _ prefix convention (#5199)

* Add _ to dogfood docs folder to cover against edge case * Fix edge case with MDX partials when site / content dir contains a _ prefix * add globUtils tests * proper dogfooding folder re-organization, all content plugins being used * refactor dogfooding folder + expose /tests page index * fix page plugin ignoring options.routeBasePath
2025-05-18 11:36:53 +02:00 · 2021-07-21 14:13:51 +02:00 · 2021-07-21 14:13:51 +02:00 · 4d06f26c1f
commit 4d06f26c1f
parent a2729128db
28 changed files with 271 additions and 54 deletions
--- a/.github/workflows/v2-build-size-report.yml
+++ b/.github/workflows/v2-build-size-report.yml
@ -26,7 +26,7 @@ jobs:
        with:
          repo-token: '${{ secrets.GITHUB_TOKEN }}'
          build-script: 'build:v2:en'
-          pattern: '{website/build/assets/js/main*js,website/build/assets/css/styles*css,website/.docusaurus/globalData.json,website/build/index.html,website/build/blog/index.html,website/build/blog/**/introducing-docusaurus/*,website/build/docs/index.html,website/build/docs/installation/index.html,website/build/docs-tests/index.html,website/build/docs-tests/standalone/index.html}'
+          pattern: '{website/build/assets/js/main*js,website/build/assets/css/styles*css,website/.docusaurus/globalData.json,website/build/index.html,website/build/blog/index.html,website/build/blog/**/introducing-docusaurus/*,website/build/docs/index.html,website/build/docs/installation/index.html,website/build/tests/docs/index.html,website/build/tests/docs/standalone/index.html}'
          strip-hash: '\.([^;]\w{7})\.'
          minimum-change-threshold: 30
          compression: 'none'
--- a/packages/docusaurus-mdx-loader/package.json
+++ b/packages/docusaurus-mdx-loader/package.json
@ -24,6 +24,7 @@
    "@docusaurus/utils": "2.0.0-beta.3",
    "@mdx-js/mdx": "^1.6.21",
    "@mdx-js/react": "^1.6.21",
+    "chalk": "^4.1.1",
    "escape-html": "^1.0.3",
    "file-loader": "^6.2.0",
    "fs-extra": "^10.0.0",
--- a/packages/docusaurus-mdx-loader/src/index.js
+++ b/packages/docusaurus-mdx-loader/src/index.js
@ -7,6 +7,7 @@

 const {readFile} = require('fs-extra');
 const mdx = require('@mdx-js/mdx');
+const chalk = require('chalk');
 const emoji = require('remark-emoji');
 const {
  parseFrontMatter,
@ -69,8 +70,8 @@ module.exports = async function docusaurusMdxLoader(fileString) {
    ],
    filepath: filePath,
  };
-  let result;

+  let result;
  try {
    result = await mdx(content, options);
  } catch (err) {
@ -90,9 +91,19 @@ module.exports = async function docusaurusMdxLoader(fileString) {
    : false;

  if (isMDXPartial && hasFrontMatter) {
-    return callback(
-      new Error(`MDX partial should not contain FrontMatter: ${filePath}`),
-    );
+    const errorMessage = `Docusaurus MDX partial files should not contain FrontMatter.
+Those partial files use the _ prefix as a convention by default, but this is configurable.
+File at ${filePath} contains FrontMatter that will be ignored: \n${JSON.stringify(
+      frontMatter,
+      null,
+      2,
+    )}`;
+    const shouldError = process.env.NODE_ENV === 'test' || process.env.CI;
+    if (shouldError) {
+      return callback(new Error(errorMessage));
+    } else {
+      console.warn(chalk.yellow(errorMessage));
+    }
  }

  if (!isMDXPartial) {
--- a/packages/docusaurus-plugin-content-blog/src/index.ts
+++ b/packages/docusaurus-plugin-content-blog/src/index.ts
@ -16,7 +16,7 @@ import {
  reportMessage,
  posixPath,
  addTrailingPathSeparator,
-  createMatcher,
+  createAbsoluteFilePathMatcher,
 } from '@docusaurus/utils';
 import {
  STATIC_DIR_NAME,
@ -437,6 +437,7 @@ export default function pluginContentBlog(
        },
      };

+      const contentDirs = getContentPathList(contentPaths);
      return {
        resolve: {
          alias: {
@ -447,7 +448,7 @@ export default function pluginContentBlog(
          rules: [
            {
              test: /(\.mdx?)$/,
-              include: getContentPathList(contentPaths)
+              include: contentDirs
                // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
                .map(addTrailingPathSeparator),
              use: [
@ -460,7 +461,10 @@ export default function pluginContentBlog(
                    beforeDefaultRemarkPlugins,
                    beforeDefaultRehypePlugins,
                    staticDir: path.join(siteDir, STATIC_DIR_NAME),
-                    isMDXPartial: createMatcher(options.exclude),
+                    isMDXPartial: createAbsoluteFilePathMatcher(
+                      options.exclude,
+                      contentDirs,
+                    ),
                    metadataPath: (mdxPath: string) => {
                      // Note that metadataPath must be the same/in-sync as
                      // the path from createData for each MDX.
--- a/packages/docusaurus-plugin-content-docs/src/index.ts
+++ b/packages/docusaurus-plugin-content-docs/src/index.ts
@ -18,7 +18,7 @@ import {
  reportMessage,
  posixPath,
  addTrailingPathSeparator,
-  createMatcher,
+  createAbsoluteFilePathMatcher,
 } from '@docusaurus/utils';
 import {LoadContext, Plugin, RouteConfig} from '@docusaurus/types';
 import {loadSidebars, createSidebarsUtils, processSidebars} from './sidebars';
@ -394,9 +394,10 @@ export default function pluginContentDocs(
      };

      function createMDXLoaderRule(): RuleSetRule {
+        const contentDirs = flatten(versionsMetadata.map(getDocsDirPaths));
        return {
          test: /(\.mdx?)$/,
-          include: flatten(versionsMetadata.map(getDocsDirPaths))
+          include: contentDirs
            // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
            .map(addTrailingPathSeparator),
          use: compact([
@ -409,7 +410,10 @@ export default function pluginContentDocs(
                beforeDefaultRehypePlugins,
                beforeDefaultRemarkPlugins,
                staticDir: path.join(siteDir, STATIC_DIR_NAME),
-                isMDXPartial: createMatcher(options.exclude),
+                isMDXPartial: createAbsoluteFilePathMatcher(
+                  options.exclude,
+                  contentDirs,
+                ),
                metadataPath: (mdxPath: string) => {
                  // Note that metadataPath must be the same/in-sync as
                  // the path from createData for each MDX.
--- a/packages/docusaurus-plugin-content-pages/src/index.ts
+++ b/packages/docusaurus-plugin-content-pages/src/index.ts
@ -16,7 +16,8 @@ import {
  getFolderContainingFile,
  addTrailingPathSeparator,
  Globby,
-  createMatcher,
+  createAbsoluteFilePathMatcher,
+  normalizeUrl,
 } from '@docusaurus/utils';
 import {
  LoadContext,
@ -124,8 +125,11 @@ export default function pluginContentPages(

        const source = path.join(contentPath, relativeSource);
        const aliasedSourcePath = aliasedSitePath(source, siteDir);
-        const pathName = encodePath(fileToPath(relativeSource));
-        const permalink = pathName.replace(/^\//, baseUrl || '');
+        const permalink = normalizeUrl([
+          baseUrl,
+          options.routeBasePath,
+          encodePath(fileToPath(relativeSource)),
+        ]);
        if (isMarkdownSource(relativeSource)) {
          return {
            type: 'mdx',
@ -194,6 +198,7 @@ export default function pluginContentPages(
        beforeDefaultRehypePlugins,
        beforeDefaultRemarkPlugins,
      } = options;
+      const contentDirs = getContentPathList(contentPaths);
      return {
        resolve: {
          alias: {
@ -204,7 +209,7 @@ export default function pluginContentPages(
          rules: [
            {
              test: /(\.mdx?)$/,
-              include: getContentPathList(contentPaths)
+              include: contentDirs
                // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
                .map(addTrailingPathSeparator),
              use: [
@ -217,7 +222,10 @@ export default function pluginContentPages(
                    beforeDefaultRehypePlugins,
                    beforeDefaultRemarkPlugins,
                    staticDir: path.join(siteDir, STATIC_DIR_NAME),
-                    isMDXPartial: createMatcher(options.exclude),
+                    isMDXPartial: createAbsoluteFilePathMatcher(
+                      options.exclude,
+                      contentDirs,
+                    ),
                    metadataPath: (mdxPath: string) => {
                      // Note that metadataPath must be the same/in-sync as
                      // the path from createData for each MDX.
--- a/packages/docusaurus-utils/src/tests/globUtils.test.ts
+++ b/packages/docusaurus-utils/src/tests/globUtils.test.ts
@ -0,0 +1,109 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {
+  GlobExcludeDefault,
+  createMatcher,
+  createAbsoluteFilePathMatcher,
+} from '../globUtils';
+
+describe('createMatcher', () => {
+  const matcher = createMatcher(GlobExcludeDefault);
+
+  test('match default exclude MD/MDX partials correctly', () => {
+    expect(matcher('doc.md')).toEqual(false);
+    expect(matcher('category/doc.md')).toEqual(false);
+    expect(matcher('category/subcategory/doc.md')).toEqual(false);
+    //
+    expect(matcher('doc.mdx')).toEqual(false);
+    expect(matcher('category/doc.mdx')).toEqual(false);
+    expect(matcher('category/subcategory/doc.mdx')).toEqual(false);
+    //
+    expect(matcher('_doc.md')).toEqual(true);
+    expect(matcher('category/_doc.md')).toEqual(true);
+    expect(matcher('category/subcategory/_doc.md')).toEqual(true);
+    expect(matcher('_category/doc.md')).toEqual(true);
+    expect(matcher('_category/subcategory/doc.md')).toEqual(true);
+    expect(matcher('category/_subcategory/doc.md')).toEqual(true);
+  });
+
+  test('match default exclude tests correctly', () => {
+    expect(matcher('xyz.js')).toEqual(false);
+    expect(matcher('xyz.ts')).toEqual(false);
+    expect(matcher('xyz.jsx')).toEqual(false);
+    expect(matcher('xyz.tsx')).toEqual(false);
+    expect(matcher('folder/xyz.js')).toEqual(false);
+    expect(matcher('folder/xyz.ts')).toEqual(false);
+    expect(matcher('folder/xyz.jsx')).toEqual(false);
+    expect(matcher('folder/xyz.tsx')).toEqual(false);
+    //
+    expect(matcher('xyz.test.js')).toEqual(true);
+    expect(matcher('xyz.test.ts')).toEqual(true);
+    expect(matcher('xyz.test.jsx')).toEqual(true);
+    expect(matcher('xyz.test.tsx')).toEqual(true);
+    expect(matcher('folder/xyz.test.js')).toEqual(true);
+    expect(matcher('folder/xyz.test.ts')).toEqual(true);
+    expect(matcher('folder/xyz.test.jsx')).toEqual(true);
+    expect(matcher('folder/xyz.test.tsx')).toEqual(true);
+    expect(matcher('folder/subfolder/xyz.test.js')).toEqual(true);
+    expect(matcher('folder/subfolder/xyz.test.ts')).toEqual(true);
+    expect(matcher('folder/subfolder/xyz.test.jsx')).toEqual(true);
+    expect(matcher('folder/subfolder/xyz.test.tsx')).toEqual(true);
+    //
+    expect(matcher('__tests__/subfolder/xyz.js')).toEqual(true);
+    expect(matcher('__tests__/subfolder/xyz.ts')).toEqual(true);
+    expect(matcher('__tests__/subfolder/xyz.jsx')).toEqual(true);
+    expect(matcher('__tests__/subfolder/xyz.tsx')).toEqual(true);
+    expect(matcher('folder/__tests__/xyz.js')).toEqual(true);
+    expect(matcher('folder/__tests__/xyz.ts')).toEqual(true);
+    expect(matcher('folder/__tests__/xyz.jsx')).toEqual(true);
+    expect(matcher('folder/__tests__/xyz.tsx')).toEqual(true);
+  });
+});
+
+describe('createAbsoluteFilePathMatcher', () => {
+  const rootFolders = ['/_root/docs', '/root/_docs/', '/__test__/website/src'];
+
+  const matcher = createAbsoluteFilePathMatcher(
+    GlobExcludeDefault,
+    rootFolders,
+  );
+
+  test('match default exclude MD/MDX partials correctly', () => {
+    expect(matcher('/_root/docs/myDoc.md')).toEqual(false);
+    expect(matcher('/_root/docs/myDoc.mdx')).toEqual(false);
+    expect(matcher('/root/_docs/myDoc.md')).toEqual(false);
+    expect(matcher('/root/_docs/myDoc.mdx')).toEqual(false);
+    expect(matcher('/_root/docs/category/myDoc.md')).toEqual(false);
+    expect(matcher('/_root/docs/category/myDoc.mdx')).toEqual(false);
+    expect(matcher('/root/_docs/category/myDoc.md')).toEqual(false);
+    expect(matcher('/root/_docs/category/myDoc.mdx')).toEqual(false);
+    //
+    expect(matcher('/_root/docs/_myDoc.md')).toEqual(true);
+    expect(matcher('/_root/docs/_myDoc.mdx')).toEqual(true);
+    expect(matcher('/root/_docs/_myDoc.md')).toEqual(true);
+    expect(matcher('/root/_docs/_myDoc.mdx')).toEqual(true);
+    expect(matcher('/_root/docs/_category/myDoc.md')).toEqual(true);
+    expect(matcher('/_root/docs/_category/myDoc.mdx')).toEqual(true);
+    expect(matcher('/root/_docs/_category/myDoc.md')).toEqual(true);
+    expect(matcher('/root/_docs/_category/myDoc.mdx')).toEqual(true);
+  });
+
+  test('match default exclude tests correctly', () => {
+    expect(matcher('/__test__/website/src/xyz.js')).toEqual(false);
+    expect(matcher('/__test__/website/src/__test__/xyz.js')).toEqual(true);
+    expect(matcher('/__test__/website/src/xyz.test.js')).toEqual(true);
+  });
+
+  test('throw if file is not contained in any root doc', () => {
+    expect(() =>
+      matcher('/bad/path/myDoc.md'),
+    ).toThrowErrorMatchingInlineSnapshot(
+      `"createAbsoluteFilePathMatcher unexpected error, absoluteFilePath=/bad/path/myDoc.md was not contained in any of the root folders [\\"/_root/docs\\",\\"/root/_docs/\\",\\"/__test__/website/src\\"]"`,
+    );
+  });
+});
--- a/packages/docusaurus-utils/src/globUtils.ts
+++ b/packages/docusaurus-utils/src/globUtils.ts
@ -8,8 +8,8 @@
 // Globby/Micromatch are the 2 libs we use in Docusaurus consistently

 export {default as Globby} from 'globby';
-
 import Micromatch from 'micromatch'; // Note: Micromatch is used by Globby
+import path from 'path';

 // The default patterns we ignore when globbing
 // using _ prefix for exclusion by convention
@ -33,3 +33,31 @@ export function createMatcher(patterns: string[]): Matcher {
  );
  return (str) => regexp.test(str);
 }
+
+// We use match patterns like '**/_*/**',
+// This function permits to help to:
+// Match /user/sebastien/website/docs/_partials/xyz.md
+// Ignore /user/_sebastien/website/docs/partials/xyz.md
+export function createAbsoluteFilePathMatcher(
+  patterns: string[],
+  rootFolders: string[],
+): Matcher {
+  const matcher = createMatcher(patterns);
+
+  function getRelativeFilePath(absoluteFilePath: string) {
+    const rootFolder = rootFolders.find((folderPath) =>
+      absoluteFilePath.startsWith(folderPath),
+    );
+    if (!rootFolder) {
+      throw new Error(
+        `createAbsoluteFilePathMatcher unexpected error, absoluteFilePath=${absoluteFilePath} was not contained in any of the root folders ${JSON.stringify(
+          rootFolders,
+        )}`,
+      );
+    }
+    return path.relative(rootFolder, absoluteFilePath);
+  }
+
+  return (absoluteFilePath: string) =>
+    matcher(getRelativeFilePath(absoluteFilePath));
+}
--- a/packages/docusaurus-utils/src/index.ts
+++ b/packages/docusaurus-utils/src/index.ts
@ -31,7 +31,12 @@ export * from './markdownParser';
 export * from './markdownLinks';
 export * from './escapePath';
 export {md5Hash, simpleHash, docuHash} from './hashUtils';
-export {Globby, GlobExcludeDefault, createMatcher} from './globUtils';
+export {
+  Globby,
+  GlobExcludeDefault,
+  createMatcher,
+  createAbsoluteFilePathMatcher,
+} from './globUtils';

 const fileHash = new Map();
 export async function generate(
--- a/website/_dogfooding/README.md
+++ b/website/_dogfooding/README.md
@ -0,0 +1,13 @@
+# Docusaurus website dogfooding
+
+This is where we test edge cases of Docusaurus by using fancy configs, ensuring they all don't fail during a real site build.
+
+Eventually, we could move these tests later so another test site? Note there is value to keep seeing the live result of those tests.
+
+Fancy things we can test for here:
+
+- Plugin Multi-instance
+- Symlinks support
+- Webpack configs
+- \_ prefix convention
+- Huge sidebars impact
--- a/website/_dogfooding/_blog-tests/2020-08-03-second-blog-intro.md
+++ b/website/_dogfooding/_blog-tests/2020-08-03-second-blog-intro.md
--- a/website/_dogfooding/_blog-tests/_partial.mdx
+++ b/website/_dogfooding/_blog-tests/_partial.mdx
--- a/website/_dogfooding/_docs-tests/index.md
+++ b/website/_dogfooding/_docs-tests/index.md
--- a/website/_dogfooding/_docs-tests/standalone.md
+++ b/website/_dogfooding/_docs-tests/standalone.md
--- a/website/_dogfooding/_pages-tests/_pagePartial.md
+++ b/website/_dogfooding/_pages-tests/_pagePartial.md
@ -0,0 +1,3 @@
+### Page partial content
+
+This is text coming from a page partial
--- a/website/_dogfooding/_pages-tests/index.md
+++ b/website/_dogfooding/_pages-tests/index.md
@ -0,0 +1,9 @@
+## Page
+
+Let's import some MDX partial:
+
+```mdx-code-block
+import PagePartial from "./_pagePartial.md"
+
+<PagePartial />
+```
--- a/website/_dogfooding/clientModuleExample.ts
+++ b/website/_dogfooding/clientModuleExample.ts
--- a/website/_dogfooding/docs-tests-sidebars.js
+++ b/website/_dogfooding/docs-tests-sidebars.js
--- a/website/_dogfooding/docs-tests-symlink
+++ b/website/_dogfooding/docs-tests-symlink
@ -0,0 +1 @@
+_docs-tests
--- a/website/_dogfooding/dogfooding.config.js
+++ b/website/_dogfooding/dogfooding.config.js
@ -0,0 +1,42 @@
+const fs = require('fs');
+const path = require('path');
+
+exports.dogfoodingPluginInstances = [
+  [
+    '@docusaurus/plugin-content-docs',
+    {
+      id: 'docs-tests',
+      routeBasePath: '/tests/docs',
+      sidebarPath: '_dogfooding/docs-tests-sidebars.js',
+
+      // Using a symlinked folder as source, test for use-case https://github.com/facebook/docusaurus/issues/3272
+      // The target folder uses a _ prefix to test against an edge case regarding MDX partials: https://github.com/facebook/docusaurus/discussions/5181#discussioncomment-1018079
+      path: fs.realpathSync('_dogfooding/docs-tests-symlink'),
+    },
+  ],
+
+  [
+    '@docusaurus/plugin-content-blog',
+    {
+      id: 'blog-tests',
+      path: '_dogfooding/_blog-tests',
+      routeBasePath: '/tests/blog',
+      editUrl:
+        'https://github.com/facebook/docusaurus/edit/master/website/_dogfooding/_blog-tests',
+      postsPerPage: 3,
+      feedOptions: {
+        type: 'all',
+        copyright: `Copyright © ${new Date().getFullYear()} Facebook, Inc.`,
+      },
+    },
+  ],
+
+  [
+    '@docusaurus/plugin-content-pages',
+    {
+      id: 'pages-tests',
+      path: '_dogfooding/_pages-tests',
+      routeBasePath: '/tests/pages',
+    },
+  ],
+];
--- a/website/docs/blog.md
+++ b/website/docs/blog.md
@ -222,4 +222,4 @@ module.exports = {
 };
 ```

-As an example, we host a second blog [here](/second-blog).
+As an example, we host a second blog [here](/tests/blog).
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@ -5,12 +5,12 @@
 * LICENSE file in the root directory of this source tree.
 */

-const fs = require('fs');
 const path = require('path');
 const versions = require('./versions.json');
 const math = require('remark-math');
 const katex = require('rehype-katex');
 const VersionsArchived = require('./versionsArchived.json');
+const {dogfoodingPluginInstances} = require('./_dogfooding/dogfooding.config');

 // This probably only makes sense for the beta phase, temporary
 function getNextBetaVersionName() {
@ -96,7 +96,7 @@ const isVersioningDisabled = !!process.env.DISABLE_VERSIONING || isI18nStaging;
    description:
      'An optimized site generator in React. Docusaurus helps you to move fast and write content. Build documentation websites, blogs, marketing pages, and more.',
  },
-  clientModules: [require.resolve('./dogfooding/clientModuleExample.ts')],
+  clientModules: [require.resolve('./_dogfooding/clientModuleExample.ts')],
  themes: ['@docusaurus/theme-live-codeblock'],
  plugins: [
    [
@ -117,34 +117,6 @@ const isVersioningDisabled = !!process.env.DISABLE_VERSIONING || isI18nStaging;
        showLastUpdateTime: true,
      },
    ],
-    [
-      '@docusaurus/plugin-content-docs',
-      {
-        // This plugin instance is used to test fancy edge cases
-        id: 'docs-tests',
-        routeBasePath: 'docs-tests',
-        sidebarPath: 'dogfooding/docs-tests-sidebars.js',
-
-        // Using a symlinked folder as source, test for use-case https://github.com/facebook/docusaurus/issues/3272
-        path: fs.realpathSync('dogfooding/docs-tests-symlink'),
-      },
-    ],
-
-    [
-      '@docusaurus/plugin-content-blog',
-      {
-        id: 'second-blog',
-        path: 'dogfooding/second-blog',
-        routeBasePath: 'second-blog',
-        editUrl:
-          'https://github.com/facebook/docusaurus/edit/master/website/dogfooding',
-        postsPerPage: 3,
-        feedOptions: {
-          type: 'all',
-          copyright: `Copyright © ${new Date().getFullYear()} Facebook, Inc.`,
-        },
-      },
-    ],
    [
      '@docusaurus/plugin-client-redirects',
      {
@ -242,6 +214,7 @@ const isVersioningDisabled = !!process.env.DISABLE_VERSIONING || isI18nStaging;
        ],
      },
    ],
+    ...dogfoodingPluginInstances,
  ],
  presets: [
    [
--- a/website/dogfooding/docs-tests-symlink
+++ b/website/dogfooding/docs-tests-symlink
@ -1 +0,0 @@
-docs-tests
--- a/website/src/pages/tests.md
+++ b/website/src/pages/tests.md
@ -0,0 +1,7 @@
+# Tests
+
+Docusaurus use some extra plugin instances for testing / dogfooding purpose:
+
+- [/tests/docs](/tests/docs)
+- [/tests/blog](/tests/blog)
+- [/tests/pages](/tests/pages)
--- a/website/versioned_docs/version-2.0.0-beta.0/blog.md
+++ b/website/versioned_docs/version-2.0.0-beta.0/blog.md
@ -219,4 +219,4 @@ module.exports = {
 };
 ```

-As an example, we host a second blog [here](/second-blog).
+As an example, we host a second blog [here](/tests/blog).
--- a/website/versioned_docs/version-2.0.0-beta.1/blog.md
+++ b/website/versioned_docs/version-2.0.0-beta.1/blog.md
@ -222,4 +222,4 @@ module.exports = {
 };
 ```

-As an example, we host a second blog [here](/second-blog).
+As an example, we host a second blog [here](/tests/blog).
--- a/website/versioned_docs/version-2.0.0-beta.2/blog.md
+++ b/website/versioned_docs/version-2.0.0-beta.2/blog.md
@ -222,4 +222,4 @@ module.exports = {
 };
 ```

-As an example, we host a second blog [here](/second-blog).
+As an example, we host a second blog [here](/tests/blog).
--- a/website/versioned_docs/version-2.0.0-beta.3/blog.md
+++ b/website/versioned_docs/version-2.0.0-beta.3/blog.md
@ -222,4 +222,4 @@ module.exports = {
 };
 ```

-As an example, we host a second blog [here](/second-blog).
+As an example, we host a second blog [here](/tests/blog).