@docusaurus/plugin-content-docs 2.0.0-beta.1ab8aa0af → 2.0.0-beta.2

package/lib/slug.js

@@ -24,8 +24,8 @@ function getSlug({ baseID, frontmatterSlug, dirName, stripDirNumberPrefixes = tr
         slug = utils_1.resolvePathname(baseSlug, resolveDirname);
     }
     if (!utils_1.isValidPathname(slug)) {
-        throw new Error(`We couldn't compute a valid slug for document with id=${baseID} in folder=${dirName}
-The slug we computed looks invalid: ${slug}
+        throw new Error(`We couldn't compute a valid slug for document with id "${baseID}" in "${dirName}" directory.
+The slug we computed looks invalid: ${slug}.
 Maybe your slug frontmatter is incorrect or you use weird chars in the file path?
 By using the slug frontmatter, you should be able to fix this error, by using the slug of your choice:
 

package/lib/types.d.ts

@@ -20,6 +20,7 @@ export declare type VersionMetadata = ContentPaths & {
     versionPath: string;
     versionEditUrl?: string | undefined;
     versionEditUrlLocalized?: string | undefined;
+    versionBanner: VersionBanner;
     isLast: boolean;
     sidebarFilePath: string | false | undefined;
     routePriority: number | undefined;
@@ -45,9 +46,11 @@ export declare type PathOptions = {
     path: string;
     sidebarPath?: string | false | undefined;
 };
+export declare type VersionBanner = 'none' | 'unreleased' | 'unmaintained';
 export declare type VersionOptions = {
     path?: string;
     label?: string;
+    banner?: VersionBanner;
 };
 export declare type VersionsOptions = {
     lastVersion?: string;
@@ -61,7 +64,6 @@ export declare type PluginOptions = MetadataOptions & PathOptions & VersionsOpti
     docItemComponent: string;
     admonitions: Record<string, unknown>;
     disableVersioning: boolean;
-    excludeNextVersionDocs?: boolean;
     includeCurrentVersion: boolean;
     sidebarItemsGenerator: SidebarItemsGeneratorOption;
 };
@@ -124,8 +126,20 @@ export declare type LastUpdateData = {
     formattedLastUpdatedAt?: string;
     lastUpdatedBy?: string;
 };
-export declare type FrontMatter = {
-    [key: string]: any;
+export declare type DocFrontMatter = {
+    id?: string;
+    title?: string;
+    hide_title?: boolean;
+    hide_table_of_contents?: boolean;
+    keywords?: string[];
+    image?: string;
+    description?: string;
+    slug?: string;
+    sidebar_label?: string;
+    sidebar_position?: number;
+    pagination_label?: string;
+    custom_edit_url?: string | null;
+    parse_number_prefixes?: boolean;
 };
 export declare type DocMetadataBase = LastUpdateData & {
     version: VersionName;
@@ -138,10 +152,9 @@ export declare type DocMetadataBase = LastUpdateData & {
     sourceDirName: string;
     slug: string;
     permalink: string;
-    sidebar_label?: string;
     sidebarPosition?: number;
     editUrl?: string | null;
-    frontMatter: FrontMatter;
+    frontMatter: DocFrontMatter & Record<string, unknown>;
 };
 export declare type DocNavLink = {
     title: string;

package/lib/versions.js

@@ -14,6 +14,7 @@ const constants_1 = require("./constants");
 const constants_2 = require("@docusaurus/core/lib/constants");
 const utils_1 = require("@docusaurus/utils");
 const lodash_1 = require("lodash");
+const sidebars_1 = require("./sidebars");
 // retro-compatibility: no prefix for the default plugin id
 function addPluginIdPrefix(fileOrDir, pluginId) {
     if (pluginId === constants_2.DEFAULT_PLUGIN_ID) {
@@ -37,16 +38,16 @@ function getVersionsFilePath(siteDir, pluginId) {
 exports.getVersionsFilePath = getVersionsFilePath;
 function ensureValidVersionString(version) {
     if (typeof version !== 'string') {
-        throw new Error(`versions should be strings. Found type=[${typeof version}] for version=[${version}]`);
+        throw new Error(`Versions should be strings. Found type "${typeof version}" for version "${version}".`);
     }
     // Should we forbid versions with special chars like / ?
     if (version.trim().length === 0) {
-        throw new Error(`Invalid version=[${version}]`);
+        throw new Error(`Invalid version "${version}".`);
     }
 }
 function ensureValidVersionArray(versionArray) {
     if (!(versionArray instanceof Array)) {
-        throw new Error(`The versions file should contain an array of versions! Found content=${JSON.stringify(versionArray)}`);
+        throw new Error(`The versions file should contain an array of versions! Found content: ${JSON.stringify(versionArray)}`);
     }
     versionArray.forEach(ensureValidVersionString);
 }
@@ -66,7 +67,7 @@ function readVersionsFile(siteDir, pluginId) {
 function readVersionNames(siteDir, options) {
     const versionFileContent = readVersionsFile(siteDir, options.id);
     if (!versionFileContent && options.disableVersioning) {
-        throw new Error(`Docs: using disableVersioning=${options.disableVersioning} option on a non-versioned site does not make sense`);
+        throw new Error(`Docs: using "disableVersioning=${options.disableVersioning}" option on a non-versioned site does not make sense.`);
     }
     const versions = options.disableVersioning ? [] : versionFileContent !== null && versionFileContent !== void 0 ? versionFileContent : [];
     // We add the current version at the beginning, unless
@@ -77,7 +78,7 @@ function readVersionNames(siteDir, options) {
         versions.unshift(constants_1.CURRENT_VERSION_NAME);
     }
     if (versions.length === 0) {
-        throw new Error(`It is not possible to use docs without any version. Please check the configuration of these options: includeCurrentVersion=${options.includeCurrentVersion} disableVersioning=${options.disableVersioning}`);
+        throw new Error(`It is not possible to use docs without any version. Please check the configuration of these options: "includeCurrentVersion=${options.includeCurrentVersion}", "disableVersioning=${options.disableVersioning}".`);
     }
     return versions;
 }
@@ -107,9 +108,7 @@ function getVersionMetadataPaths({ versionName, context, options, }) {
     });
     function getSidebarFilePath() {
         if (isCurrentVersion) {
-            return options.sidebarPath
-                ? path_1.default.resolve(context.siteDir, options.sidebarPath)
-                : options.sidebarPath;
+            return sidebars_1.resolveSidebarPathOption(context.siteDir, options.sidebarPath);
         }
         else {
             return path_1.default.join(getVersionedSidebarsDirPath(context.siteDir, options.id), `version-${versionName}-sidebars.json`);
@@ -151,20 +150,46 @@ function getVersionEditUrls({ contentPath, contentPathLocalized, context: { site
         versionEditUrlLocalized,
     };
 }
-function createVersionMetadata({ versionName, isLast, context, options, }) {
+function getDefaultVersionBanner({ versionName, versionNames, lastVersionName, }) {
+    // Current version: good, no banner
+    if (versionName === lastVersionName) {
+        return 'none';
+    }
+    // Upcoming versions: unreleased banner
+    else if (versionNames.indexOf(versionName) < versionNames.indexOf(lastVersionName)) {
+        return 'unreleased';
+    }
+    // Older versions: display unmaintained banner
+    else {
+        return 'unmaintained';
+    }
+}
+function getVersionBanner({ versionName, versionNames, lastVersionName, options, }) {
+    var _a;
+    const versionOptionBanner = (_a = options.versions[versionName]) === null || _a === void 0 ? void 0 : _a.banner;
+    return (versionOptionBanner !== null && versionOptionBanner !== void 0 ? versionOptionBanner : getDefaultVersionBanner({
+        versionName,
+        versionNames,
+        lastVersionName,
+    }));
+}
+function createVersionMetadata({ versionName, versionNames, lastVersionName, context, options, }) {
     var _a, _b, _c;
     const { sidebarFilePath, contentPath, contentPathLocalized, } = getVersionMetadataPaths({
         versionName,
         context,
         options,
     });
+    const isLast = versionName === lastVersionName;
     // retro-compatible values
     const defaultVersionLabel = versionName === constants_1.CURRENT_VERSION_NAME ? 'Next' : versionName;
-    const defaultVersionPathPart = isLast
-        ? ''
-        : versionName === constants_1.CURRENT_VERSION_NAME
-            ? 'next'
-            : versionName;
+    function getDefaultVersionPathPart() {
+        if (isLast) {
+            return '';
+        }
+        return versionName === constants_1.CURRENT_VERSION_NAME ? 'next' : versionName;
+    }
+    const defaultVersionPathPart = getDefaultVersionPathPart();
     const versionOptions = (_a = options.versions[versionName]) !== null && _a !== void 0 ? _a : {};
     const versionLabel = (_b = versionOptions.label) !== null && _b !== void 0 ? _b : defaultVersionLabel;
     const versionPathPart = (_c = versionOptions.path) !== null && _c !== void 0 ? _c : defaultVersionPathPart;
@@ -187,6 +212,12 @@ function createVersionMetadata({ versionName, isLast, context, options, }) {
         versionPath,
         versionEditUrl: versionEditUrls === null || versionEditUrls === void 0 ? void 0 : versionEditUrls.versionEditUrl,
         versionEditUrlLocalized: versionEditUrls === null || versionEditUrls === void 0 ? void 0 : versionEditUrls.versionEditUrlLocalized,
+        versionBanner: getVersionBanner({
+            versionName,
+            versionNames,
+            lastVersionName,
+            options,
+        }),
         isLast,
         routePriority,
         sidebarFilePath,
@@ -199,7 +230,7 @@ function checkVersionMetadataPaths({ versionMetadata, context, }) {
     const { siteDir } = context;
     const isCurrentVersion = versionName === constants_1.CURRENT_VERSION_NAME;
     if (!fs_extra_1.default.existsSync(contentPath)) {
-        throw new Error(`The docs folder does not exist for version [${versionName}]. A docs folder is expected to be found at ${path_1.default.relative(siteDir, contentPath)}`);
+        throw new Error(`The docs folder does not exist for version "${versionName}". A docs folder is expected to be found at ${path_1.default.relative(siteDir, contentPath)}.`);
     }
     // If the current version defines a path to a sidebar file  that does not exist, we throw!
     // Note: for versioned sidebars, the file may not exist (as we prefer to not create it rather than to create an empty file)
@@ -208,8 +239,8 @@ function checkVersionMetadataPaths({ versionMetadata, context, }) {
     if (isCurrentVersion &&
         typeof sidebarFilePath === 'string' &&
         !fs_extra_1.default.existsSync(sidebarFilePath)) {
-        throw new Error(`The path to the sidebar file does not exist at [${path_1.default.relative(siteDir, sidebarFilePath)}].
-Please set the docs [sidebarPath] field in your config file to:
+        throw new Error(`The path to the sidebar file does not exist at "${path_1.default.relative(siteDir, sidebarFilePath)}".
+Please set the docs "sidebarPath" field in your config file to:
 - a sidebars path that exists
 - false: to disable the sidebar
 - undefined: for Docusaurus generates it automatically`);
@@ -234,19 +265,19 @@ function checkVersionsOptions(availableVersionNames, options) {
     }
     const unknownVersionConfigNames = lodash_1.difference(Object.keys(options.versions), availableVersionNames);
     if (unknownVersionConfigNames.length > 0) {
-        throw new Error(`Bad docs options.versions: unknown versions found: ${unknownVersionConfigNames.join(',')}. ${availableVersionNamesMsg}`);
+        throw new Error(`Invalid docs option "versions": unknown versions (${unknownVersionConfigNames.join(',')}) found. ${availableVersionNamesMsg}`);
     }
     if (options.onlyIncludeVersions) {
         if (options.onlyIncludeVersions.length === 0) {
-            throw new Error(`Bad docs options.onlyIncludeVersions: an empty array is not allowed, at least one version is needed`);
+            throw new Error(`Invalid docs option "onlyIncludeVersions": an empty array is not allowed, at least one version is needed.`);
         }
         const unknownOnlyIncludeVersionNames = lodash_1.difference(options.onlyIncludeVersions, availableVersionNames);
         if (unknownOnlyIncludeVersionNames.length > 0) {
-            throw new Error(`Bad docs options.onlyIncludeVersions: unknown versions found: ${unknownOnlyIncludeVersionNames.join(',')}. ${availableVersionNamesMsg}`);
+            throw new Error(`Invalid docs option "onlyIncludeVersions": unknown versions (${unknownOnlyIncludeVersionNames.join(',')}) found. ${availableVersionNamesMsg}`);
         }
         if (options.lastVersion &&
             !options.onlyIncludeVersions.includes(options.lastVersion)) {
-            throw new Error(`Bad docs options.lastVersion: if you use both the onlyIncludeVersions and lastVersion options, then lastVersion must be present in the provided onlyIncludeVersions array`);
+            throw new Error(`Invalid docs option "lastVersion": if you use both the "onlyIncludeVersions" and "lastVersion" options, then "lastVersion" must be present in the provided "onlyIncludeVersions" array.`);
         }
     }
 }
@@ -270,7 +301,8 @@ function readVersionsMetadata({ context, options, }) {
     const lastVersionName = (_a = options.lastVersion) !== null && _a !== void 0 ? _a : getDefaultLastVersionName(versionNames);
     const versionsMetadata = versionNames.map((versionName) => createVersionMetadata({
         versionName,
-        isLast: versionName === lastVersionName,
+        versionNames,
+        lastVersionName,
         context,
         options,
     }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "2.0.0-beta.1ab8aa0af",
+  "version": "2.0.0-beta.2",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-docs.d.ts",
@@ -18,22 +18,23 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.1ab8aa0af",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.2",
     "@types/js-yaml": "^4.0.0",
     "@types/picomatch": "^2.2.1",
     "commander": "^5.1.0",
     "picomatch": "^2.1.1"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.1ab8aa0af",
-    "@docusaurus/mdx-loader": "2.0.0-beta.1ab8aa0af",
-    "@docusaurus/types": "2.0.0-beta.1ab8aa0af",
-    "@docusaurus/utils": "2.0.0-beta.1ab8aa0af",
-    "@docusaurus/utils-validation": "2.0.0-beta.1ab8aa0af",
-    "chalk": "^4.1.0",
+    "@docusaurus/core": "2.0.0-beta.2",
+    "@docusaurus/mdx-loader": "2.0.0-beta.2",
+    "@docusaurus/types": "2.0.0-beta.2",
+    "@docusaurus/utils": "2.0.0-beta.2",
+    "@docusaurus/utils-validation": "2.0.0-beta.2",
+    "chalk": "^4.1.1",
     "combine-promises": "^1.1.0",
+    "escape-string-regexp": "^4.0.0",
     "execa": "^5.0.0",
-    "fs-extra": "^9.1.0",
+    "fs-extra": "^10.0.0",
     "globby": "^11.0.2",
     "import-fresh": "^3.2.2",
     "js-yaml": "^4.0.0",
@@ -41,9 +42,9 @@
     "lodash": "^4.17.20",
     "remark-admonitions": "^1.2.1",
     "shelljs": "^0.8.4",
-    "tslib": "^2.1.0",
+    "tslib": "^2.2.0",
     "utility-types": "^3.10.0",
-    "webpack": "^5.28.0"
+    "webpack": "^5.40.0"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
@@ -52,5 +53,5 @@
   "engines": {
     "node": ">=12.13.0"
   },
-  "gitHead": "63c06baac39707a1a4c3cc4c0031cb2163f256c4"
+  "gitHead": "883f07fddffaf1657407c8e202e370cc436e25f7"
 }

package/src/__tests__/__fixtures__/simple-site/docs/foo/baz.md

@@ -2,8 +2,11 @@
 id: baz
 title: baz
 slug: bazSlug.html
+pagination_label: baz pagination_label
 ---
 
+# Baz markdown title
+
 ## Images
 
 Like links, Images also have a footnote style syntax
@@ -34,7 +37,7 @@ Duplicated footnote reference[^second].
 
 [^first]: Footnote **can have markup**
 
-  and multiple paragraphs.
+and multiple paragraphs.
 
 [^second]: Footnote text.
 

package/src/__tests__/__fixtures__/simple-site/docs/hello.md

@@ -1,6 +1,7 @@
 ---
 id: hello
 title: Hello, World !
+sidebar_label: Hello sidebar_label
 ---
 
 Hi, Endilie here :)

package/src/__tests__/__snapshots__/index.test.ts.snap

@@ -1,11 +1,11 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`sidebar site with wrong sidebar content 1`] = `
-"Bad sidebars file.
+"Invalid sidebar file at \\"packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/wrong-sidebars.json\\".
 These sidebar document ids do not exist:
-- goku,
+- goku
 
-Available document ids=
+Available document ids are:
 - foo/bar
 - foo/baz
 - headingAsTitle
@@ -168,7 +168,7 @@ Object {
   \\"unversionedId\\": \\"foo/bar\\",
   \\"id\\": \\"foo/bar\\",
   \\"isDocsHomePage\\": false,
-  \\"title\\": \\"Remarkable\\",
+  \\"title\\": \\"Bar\\",
   \\"description\\": \\"This is custom description\\",
   \\"source\\": \\"@site/docs/foo/bar.md\\",
   \\"sourceDirName\\": \\"foo\\",
@@ -182,7 +182,7 @@ Object {
   },
   \\"sidebar\\": \\"docs\\",
   \\"next\\": {
-    \\"title\\": \\"baz\\",
+    \\"title\\": \\"baz pagination_label\\",
     \\"permalink\\": \\"/docs/foo/bazSlug.html\\"
   }
 }",
@@ -200,15 +200,16 @@ Object {
   \\"frontMatter\\": {
     \\"id\\": \\"baz\\",
     \\"title\\": \\"baz\\",
-    \\"slug\\": \\"bazSlug.html\\"
+    \\"slug\\": \\"bazSlug.html\\",
+    \\"pagination_label\\": \\"baz pagination_label\\"
   },
   \\"sidebar\\": \\"docs\\",
   \\"previous\\": {
-    \\"title\\": \\"Remarkable\\",
+    \\"title\\": \\"Bar\\",
     \\"permalink\\": \\"/docs/foo/bar\\"
   },
   \\"next\\": {
-    \\"title\\": \\"Hello, World !\\",
+    \\"title\\": \\"Hello sidebar_label\\",
     \\"permalink\\": \\"/docs/\\"
   }
 }",
@@ -238,11 +239,12 @@ Object {
   \\"version\\": \\"current\\",
   \\"frontMatter\\": {
     \\"id\\": \\"hello\\",
-    \\"title\\": \\"Hello, World !\\"
+    \\"title\\": \\"Hello, World !\\",
+    \\"sidebar_label\\": \\"Hello sidebar_label\\"
   },
   \\"sidebar\\": \\"docs\\",
   \\"previous\\": {
-    \\"title\\": \\"baz\\",
+    \\"title\\": \\"baz pagination_label\\",
     \\"permalink\\": \\"/docs/foo/bazSlug.html\\"
   }
 }",
@@ -403,6 +405,7 @@ Object {
   \\"pluginId\\": \\"default\\",
   \\"version\\": \\"current\\",
   \\"label\\": \\"Next\\",
+  \\"banner\\": \\"none\\",
   \\"isLast\\": true,
   \\"docsSidebars\\": {
     \\"docs\\": [
@@ -418,7 +421,7 @@ Object {
             \\"items\\": [
               {
                 \\"type\\": \\"link\\",
-                \\"label\\": \\"Remarkable\\",
+                \\"label\\": \\"Bar\\",
                 \\"href\\": \\"/docs/foo/bar\\"
               },
               {
@@ -435,7 +438,7 @@ Object {
           },
           {
             \\"type\\": \\"link\\",
-            \\"label\\": \\"Hello, World !\\",
+            \\"label\\": \\"Hello sidebar_label\\",
             \\"href\\": \\"/docs/\\"
           }
         ]
@@ -447,7 +450,7 @@ Object {
         \\"items\\": [
           {
             \\"type\\": \\"link\\",
-            \\"label\\": \\"Hello, World !\\",
+            \\"label\\": \\"Hello sidebar_label\\",
             \\"href\\": \\"/docs/\\"
           }
         ]
@@ -870,6 +873,7 @@ Object {
   \\"pluginId\\": \\"community\\",
   \\"version\\": \\"1.0.0\\",
   \\"label\\": \\"1.0.0\\",
+  \\"banner\\": \\"none\\",
   \\"isLast\\": true,
   \\"docsSidebars\\": {
     \\"version-1.0.0/community\\": [
@@ -888,6 +892,7 @@ Object {
   \\"pluginId\\": \\"community\\",
   \\"version\\": \\"current\\",
   \\"label\\": \\"Next\\",
+  \\"banner\\": \\"unreleased\\",
   \\"isLast\\": false,
   \\"docsSidebars\\": {
     \\"community\\": [
@@ -1400,6 +1405,7 @@ Object {
   \\"pluginId\\": \\"default\\",
   \\"version\\": \\"1.0.0\\",
   \\"label\\": \\"1.0.0\\",
+  \\"banner\\": \\"unmaintained\\",
   \\"isLast\\": false,
   \\"docsSidebars\\": {
     \\"version-1.0.0/docs\\": [
@@ -1444,6 +1450,7 @@ Object {
   \\"pluginId\\": \\"default\\",
   \\"version\\": \\"1.0.1\\",
   \\"label\\": \\"1.0.1\\",
+  \\"banner\\": \\"none\\",
   \\"isLast\\": true,
   \\"docsSidebars\\": {
     \\"version-1.0.1/docs\\": [
@@ -1482,6 +1489,7 @@ Object {
   \\"pluginId\\": \\"default\\",
   \\"version\\": \\"current\\",
   \\"label\\": \\"Next\\",
+  \\"banner\\": \\"unreleased\\",
   \\"isLast\\": false,
   \\"docsSidebars\\": {
     \\"docs\\": [
@@ -1520,6 +1528,7 @@ Object {
   \\"pluginId\\": \\"default\\",
   \\"version\\": \\"withSlugs\\",
   \\"label\\": \\"withSlugs\\",
+  \\"banner\\": \\"unmaintained\\",
   \\"isLast\\": false,
   \\"docsSidebars\\": {
     \\"version-1.0.1/docs\\": [

package/src/__tests__/cli.test.ts

@@ -35,7 +35,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] No version tag specified!. Pass the version you wish to create as an argument. Ex: 1.0.0"`,
+      `"[docs]: no version tag specified! Pass the version you wish to create as an argument, for example: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -45,7 +45,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] No version tag specified!. Pass the version you wish to create as an argument. Ex: 1.0.0"`,
+      `"[docs]: no version tag specified! Pass the version you wish to create as an argument, for example: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -55,7 +55,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] No version tag specified!. Pass the version you wish to create as an argument. Ex: 1.0.0"`,
+      `"[docs]: no version tag specified! Pass the version you wish to create as an argument, for example: 1.0.0."`,
     );
   });
 
@@ -68,7 +68,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Do not include slash (/) or (\\\\). Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Do not include slash (/) or backslash (\\\\). Try something like: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -78,7 +78,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Do not include slash (/) or (\\\\). Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Do not include slash (/) or backslash (\\\\). Try something like: 1.0.0."`,
     );
   });
 
@@ -91,7 +91,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Length must <= 32 characters. Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Length cannot exceed 32 characters. Try something like: 1.0.0."`,
     );
   });
 
@@ -104,7 +104,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Do not name your version \\".\\" or \\"..\\". Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Do not name your version \\".\\" or \\"..\\". Try something like: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -114,7 +114,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Do not name your version \\".\\" or \\"..\\". Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Do not name your version \\".\\" or \\"..\\". Try something like: 1.0.0."`,
     );
   });
 
@@ -127,7 +127,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -137,7 +137,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0."`,
     );
     expect(() =>
       cliDocsVersionCommand(
@@ -147,7 +147,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] Invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0"`,
+      `"[docs]: invalid version tag specified! Please ensure its a valid pathname too. Try something like: 1.0.0."`,
     );
   });
 
@@ -160,7 +160,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] This version already exists!. Use a version tag that does not already exist."`,
+      `"[docs]: this version already exists! Use a version tag that does not already exist."`,
     );
   });
 
@@ -174,7 +174,7 @@ describe('docsVersion', () => {
         DEFAULT_OPTIONS,
       ),
     ).toThrowErrorMatchingInlineSnapshot(
-      `"[docs] There is no docs to version !"`,
+      `"[docs]: there is no docs to version!"`,
     );
   });
 
@@ -218,7 +218,7 @@ describe('docsVersion', () => {
       getVersionsFilePath(simpleSiteDir, DEFAULT_PLUGIN_ID),
     );
     expect(versions).toEqual(['1.0.0']);
-    expect(consoleMock).toHaveBeenCalledWith('[docs] Version 1.0.0 created!');
+    expect(consoleMock).toHaveBeenCalledWith('[docs]: version 1.0.0 created!');
 
     copyMock.mockRestore();
     writeMock.mockRestore();
@@ -271,7 +271,7 @@ describe('docsVersion', () => {
       getVersionsFilePath(versionedSiteDir, DEFAULT_PLUGIN_ID),
     );
     expect(versions).toEqual(['2.0.0', '1.0.1', '1.0.0', 'withSlugs']);
-    expect(consoleMock).toHaveBeenCalledWith('[docs] Version 2.0.0 created!');
+    expect(consoleMock).toHaveBeenCalledWith('[docs]: version 2.0.0 created!');
 
     copyMock.mockRestore();
     writeMock.mockRestore();
@@ -322,7 +322,7 @@ describe('docsVersion', () => {
     );
     expect(versions).toEqual(['2.0.0', '1.0.0']);
     expect(consoleMock).toHaveBeenCalledWith(
-      '[community] Version 2.0.0 created!',
+      '[community]: version 2.0.0 created!',
     );
 
     copyMock.mockRestore();