Merge branch 'main' into use_optimize_720_83_for_update_guide

package.json

@@ -34,7 +34,7 @@
     "react": "^17.0.2",
     "react-dom": "^17.0.2",
     "react-player": "^2.11.0",
-    "unist-util-visit": "^4.1.2"
+    "unist-util-visit": "^5.0.0"
   },
   "browserslist": {
     "production": [

playwright.config.ts

@@ -36,8 +36,8 @@ const config: PlaywrightTestConfig = {
     /* Maximum time each action such as `click()` can take. Defaults to 0 (no limit). */
     actionTimeout: 0,
     /* Base URL to use in actions like `await page.goto('/')`. */
-    // baseURL: 'http://localhost:3000',
-    baseURL: "https://docs.camunda.io",
+    baseURL: "http://localhost:3000",
+    // baseURL: "https://docs.camunda.io",
 
     /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
     trace: "on-first-retry",

spec/regression/versionMapping.spec.ts

@@ -0,0 +1,32 @@
+import { test, expect } from "@playwright/test";
+
+test("main docs cross-link to optimize docs", async ({ page }) => {
+  await page.goto("/docs/components/");
+
+  await expect(page).toHaveTitle(
+    /Overview Components \| Camunda Platform 8 Docs/
+  );
+
+  // This is a link known to cross over to $optimize$.
+  await page
+    .getByRole("article")
+    .getByRole("link", { name: "Optimize" })
+    .click();
+
+  // The `$optimize$` should be transformed to `optimize` in the target URL.
+  await expect(page.url()).toContain("/optimize/components/what-is-optimize/");
+});
+
+test("optimize docs cross-link to main docs", async ({ page }) => {
+  await page.goto(
+    "/optimize/apis-tools/optimize-api/optimize-api-authorization/"
+  );
+
+  await expect(page).toHaveTitle(/Authorization \| Camunda Platform 8 Docs/);
+
+  // This is a link known to cross over to $docs$.
+  await page.getByRole("link", { name: "building your own client" }).click();
+
+  // The `$docs$` should be transformed to `docs` in the target URL.
+  await expect(page.url()).toContain("/docs/apis-tools/build-your-own-client/");
+});

src/pages/meta.md

@@ -78,7 +78,7 @@ In those instances, big or small, we want to make sure you can see what works wi
 
 `<span class="badge badge--cloud">Camunda Platform 8 only</span>`
 
-# Front-matter values
+## Front-matter values
 
 Your front matter should mirror the following structure when creating documentation: