docs: rebrand docs site — remove MCP Mesh/Studio product names, restructure versions (#2890)

- Rename product references from "MCP Mesh" / "MCP Studio" to "deco Studio" across all docs
- Replace mesh-admin.decocms.com URLs with studio.decocms.com
- Restructure content folders: 2026-03-10 → deco-studio, 2025-10-10 → deco-chat
- Rename mcp-mesh/ content folder to studio/
- Version dropdown: "deco Studio - current" and "deco.chat - legacy admin"
- Hide legacy admin content (no-code/full-code guides) from current version sidebar
- Rewrite overview and quickstart pages (EN + PT-BR) to reflect Studio positioning
- Add API Reference and Built-in Tools sidebar labels
- Update all internal links to new paths

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: cecilia-marques

apps/docs/client/src/components/ui/Sidebar.astro

@@ -69,12 +69,12 @@ function buildTree(docs: any[]): TreeNode[] {
         const parentPath = a.path[a.path.length - 2];
 
         // Custom order for decocms top-level pages
-        if (parentPath === "mcp-mesh") {
+        if (parentPath === "studio") {
           // NOTE: doc IDs do not include ".mdx" (e.g. "overview", not "overview.mdx")
           // Order follows: Quickstart → Overview → Core Concepts → Working with MCP → Monitoring → User Management → Reference
 
           // Version-aware ordering
-          const mcpMeshOrder =
+          const studioFolderOrder =
             version === LATEST_VERSION.id
               ? [
                   // Latest version structure
@@ -105,8 +105,8 @@ function buildTree(docs: any[]): TreeNode[] {
                   "api-reference",
                 ];
 
-          const aIndex = mcpMeshOrder.indexOf(a.name);
-          const bIndex = mcpMeshOrder.indexOf(b.name);
+          const aIndex = studioFolderOrder.indexOf(a.name);
+          const bIndex = studioFolderOrder.indexOf(b.name);
           if (aIndex !== -1 && bIndex !== -1) {
             return aIndex - bIndex;
           }
@@ -210,7 +210,7 @@ function buildTree(docs: any[]): TreeNode[] {
 
         // Custom order for deploy docs (now under self-hosting)
         const rootPath = a.path[0];
-        if (rootPath === "mcp-mesh" && parentPath === "deploy") {
+        if (rootPath === "studio" && parentPath === "deploy") {
           // Version-aware deploy file names
           const deployOrder =
             version === LATEST_VERSION.id
@@ -230,7 +230,7 @@ function buildTree(docs: any[]): TreeNode[] {
       if (a.type === "folder" && b.type === "folder") {
         const folderOrder: Record<string, number> = {
           // Order follows improved information architecture
-          "mcp-mesh": 0, // decocms docs (main product)
+          studio: 0, // decocms docs (main product)
           "getting-started": 1, // Getting Started (after intro)
           decopilot: 2, // Decopilot (elevated section within mcp-mesh)
           "self-hosting": 3, // Self-hosting section
@@ -267,17 +267,27 @@ function prefixNode(node: TreeNode, prefix: string[]): TreeNode {
   };
 }
 
-function groupLegacyAdminSections(nodes: TreeNode[]): TreeNode[] {
+function groupLegacyAdminSections(
+  nodes: TreeNode[],
+  isLatest: boolean,
+): TreeNode[] {
   const legacyRootName = "admin-decocms-com";
+  const legacyFolderNames = [
+    "no-code-guides",
+    "full-code-guides",
+    "getting-started",
+  ];
 
   const files = nodes.filter((n) => n.type === "file");
   const folders = nodes.filter((n) => n.type === "folder");
 
-  const mcpMesh = folders.find((f) => f.name === "mcp-mesh");
+  const studioFolder = folders.find((f) => f.name === "studio");
   const mcpStudio = folders.find((f) => f.name === "mcp-studio");
-  const legacyChildren = folders.filter(
-    (f) => f.name !== "mcp-mesh" && f.name !== "mcp-studio",
-  );
+
+  // For the latest version, exclude legacy admin folders entirely
+  const legacyChildren = isLatest
+    ? []
+    : folders.filter((f) => legacyFolderNames.includes(f.name));
 
   const legacyFolder: TreeNode | null =
     legacyChildren.length > 0
@@ -292,30 +302,32 @@ function groupLegacyAdminSections(nodes: TreeNode[]): TreeNode[] {
         }
       : null;
 
+  // For v0 (deco.chat), show legacy content directly without the wrapper folder
+  if (!isLatest) {
+    return legacyChildren;
+  }
+
   // Flatten mcp-mesh folder - bring its children to the top level
-  // mcp-mesh children will be shown at the top level
   const next: TreeNode[] = [];
 
   // Add any top-level files first (e.g. introduction.mdx)
   next.push(...files);
 
-  // Add all mcp-mesh children directly at top level (order controlled by mcpMeshOrder array)
-  if (mcpMesh && mcpMesh.children.length > 0) {
-    next.push(...mcpMesh.children);
+  // Add all mcp-mesh children directly at top level (order controlled by studioFolderOrder array)
+  if (studioFolder && studioFolder.children.length > 0) {
+    next.push(...studioFolder.children);
   }
 
   // Add mcp-studio as its own top-level section
   if (mcpStudio) {
     next.push(mcpStudio);
   }
 
-  // Add legacy admin section at the end
-  if (legacyFolder) next.push(legacyFolder);
-
   return next;
 }
 
-const tree = groupLegacyAdminSections(buildTree(docs));
+const isLatest = version === LATEST_VERSION.id;
+const tree = groupLegacyAdminSections(buildTree(docs), isLatest);
 
 interface FlatNode {
   name: string;

apps/docs/client/src/components/ui/Sidebar.tsx

@@ -102,7 +102,6 @@ function VersionSelector({
           {versionOptions.map((v) => (
             <option key={v.id} value={v.id}>
               {v.shortLabel}
-              {v.isLatest ? " (latest)" : ""}
             </option>
           ))}
         </select>
@@ -211,13 +210,16 @@ function TreeItem({
       return (
         <Icon
           name={
-            node.id === "mcp-mesh/self-hosting"
+            node.id === "studio/self-hosting"
               ? "Database"
-              : node.id === "mcp-mesh/self-hosting/deploy"
+              : node.id === "studio/self-hosting/deploy"
                 ? "Rocket"
-                : node.id === "mcp-mesh/decopilot"
+                : node.id === "studio/decopilot"
                   ? "Cpu"
-                  : "Folder"
+                  : node.id === "studio/api-reference" ||
+                      node.id === "api-reference"
+                    ? "Code"
+                    : "Folder"
           }
           size={16}
           className={`shrink-0 ${active ? "text-primary" : ""}`}
@@ -447,7 +449,7 @@ export default function Sidebar({
   // Handle version change by navigating to the new version's root page
   const versionRoots = Object.fromEntries(versions.map((v) => [v.id, v.root]));
   const handleVersionChange = (newVersion: string) => {
-    const root = versionRoots[newVersion] ?? "mcp-mesh/quickstart";
+    const root = versionRoots[newVersion] ?? "studio/quickstart";
     navigate(`/${newVersion}/${locale}/${root}`);
   };
 

apps/docs/client/src/config/versions.ts

@@ -9,20 +9,20 @@ export interface VersionConfig {
 
 export const versions: VersionConfig[] = [
   {
-    id: "2026-03-10",
-    label: "2026-03-10 (Current)",
-    shortLabel: "2026-03-10",
+    id: "deco-studio",
+    label: "deco Studio - current",
+    shortLabel: "deco Studio - current",
     description: "Current production docs",
     isLatest: true,
-    root: "mcp-mesh/quickstart",
+    root: "studio/quickstart",
   },
   {
-    id: "2025-10-10",
-    label: "2025-10-10",
-    shortLabel: "2025-10-10",
-    description: "Previous version docs",
+    id: "deco-chat",
+    label: "deco.chat - legacy admin",
+    shortLabel: "deco.chat - legacy admin",
+    description: "Legacy deco.chat docs",
     isLatest: false,
-    root: "introduction",
+    root: "getting-started/ai-builders",
   },
 ];