feat(docs): update documentation structure and content (#1882)

* feat(docs): update documentation structure and content

- Removed outdated guides: `bounties.mdx`, `getting-started.mdx`, and `project-structure.mdx`.
- Added new guides: `building-tools.mdx`, `building-views.mdx`, `deployment.mdx`, and `project-structure.mdx` to enhance clarity on tool creation and deployment processes.
- Updated translations in `ui.ts` for improved navigation labels in both English and Portuguese.
- Enhanced navigation logic in `navigation.ts` to ensure consistent ordering of documentation links.

* chore: update bun.lockb to reflect dependency changes

* Update docs/view/src/content/en/no-code-guides/creating-agents.mdx

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* fix(docs): correct minor translation and formatting issues in Portuguese documentation

- Updated the warning callout in `deployment.mdx` for consistency in verb tense.
- Fixed punctuation in the resource validation list in `resources.mdx`.
- Adjusted wording in the context engineers guide for clarity in `context-engineers.mdx`.

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: cecilia-marques

bun.lockb

@@ -18,22 +18,28 @@ import { AccordionGroup } from "./AccordionGroup";
 import Callout from "./Callout.astro";
 import Card from "./Card.astro";
 import { Properties } from "./Properties";
+import { ui } from "../../i18n/ui";
 
 const { doc } = Astro.props;
 const { Content } = await render(doc);
 
 // Extract breadcrumb from the path
 const pathParts = doc.id.split("/").slice(1);
+const locale = doc.id.split("/")[0] as keyof typeof ui;
+const translations = ui[locale] || ui.en;
+
+// Get translated breadcrumb if available
 const breadcrumb =
   pathParts.length > 1
-    ? pathParts[0].charAt(0).toUpperCase() + pathParts[0].slice(1)
+    ? translations[
+        `sidebar.section.${pathParts[0]}` as keyof typeof translations
+      ] || pathParts[0].charAt(0).toUpperCase() + pathParts[0].slice(1)
     : undefined;
 
 // Generate markdown path for viewing raw file
 const markdownPath = `/src/content/${doc.id}.mdx`;
 
 // Get navigation links
-const locale = doc.id.split("/")[0];
 const navigationLinks = await getNavigationLinks(doc.id, locale);
 
 // Components mapping for custom markdown rendering

docs/view/src/components/ui/RenderDocument.astro

@@ -58,25 +58,54 @@ function buildTree(docs: any[]): TreeNode[] {
 
       // For files only - custom ordering
       if (a.type === "file" && b.type === "file") {
-        // Force introduction to be first regardless of filename
+        // Force introduction to be first
         if (a.name.includes("introduction")) return -1;
         if (b.name.includes("introduction")) return 1;
 
-        // Then getting-started
-        if (a.name.includes("getting-started")) return -1;
-        if (b.name.includes("getting-started")) return 1;
-
-        // Then project-structure
-        if (a.name.includes("project-structure")) return -1;
-        if (b.name.includes("project-structure")) return 1;
+        // Get parent folder to determine which order to use
+        const parentPath = a.path[a.path.length - 2];
+
+        // Custom order for no-code-guides files
+        if (parentPath === "no-code-guides") {
+          const noCodeOrder = ["creating-tools.mdx", "creating-agents.mdx"];
+          const aIndex = noCodeOrder.indexOf(a.name);
+          const bIndex = noCodeOrder.indexOf(b.name);
+          if (aIndex !== -1 && bIndex !== -1) {
+            return aIndex - bIndex;
+          }
+          if (aIndex !== -1) return -1;
+          if (bIndex !== -1) return 1;
+        }
 
-        // Then cli-reference
-        if (a.name.includes("cli-reference")) return -1;
-        if (b.name.includes("cli-reference")) return 1;
+        // Custom order for full-code-guides files
+        if (parentPath === "full-code-guides") {
+          const fullCodeOrder = [
+            "project-structure.mdx",
+            "building-tools.mdx",
+            "building-views.mdx",
+            "resources.mdx",
+            "deployment.mdx",
+          ];
+          const aIndex = fullCodeOrder.indexOf(a.name);
+          const bIndex = fullCodeOrder.indexOf(b.name);
+          if (aIndex !== -1 && bIndex !== -1) {
+            return aIndex - bIndex;
+          }
+          if (aIndex !== -1) return -1;
+          if (bIndex !== -1) return 1;
+        }
+      }
 
-        // Then bounties (last)
-        if (a.name.includes("bounties")) return -1;
-        if (b.name.includes("bounties")) return 1;
+      // For folders - custom ordering
+      if (a.type === "folder" && b.type === "folder") {
+        // getting-started before everything else
+        if (a.name === "getting-started") return -1;
+        if (b.name === "getting-started") return 1;
+        // no-code-guides before full-code-guides
+        if (a.name === "no-code-guides") return -1;
+        if (b.name === "no-code-guides") return 1;
+        if (a.name === "full-code-guides") return -1;
+        if (b.name === "full-code-guides") return 1;
       }
 
       // Default alphabetical