adjustments to assembly tutorials

Author: matas-bitbybit-dev

docs/learn/code/common/occt/assembly/_category_.json

@@ -4,7 +4,7 @@
     "link": {
         "type": "generated-index",
         "title": "OCCT Assembly",
-        "description": "Learn how to create OCCT assemblies and manage complex parts.",
+        "description": "Work with OCCT assemblies: load STEP files, export to GLTF, parse hierarchy, create multi-part models, and preserve colors for CAD visualization.",
         "slug": "/code/common/occt/assembly"
     }
 }

docs/learn/code/common/occt/assembly/assembly-structure.mdx

@@ -1,28 +1,28 @@
 ---
 sidebar_position: 3
-title: "Structure"
+title: "Parse Assembly Structure"
 sidebar_label: Structure
-description: Learn how to analyze the structure of assembly. Bitbybit probides dedicated preview components for Visual Programmers.
+description: Extract and navigate assembly hierarchy from STEP files - find part labels, retrieve shapes, and apply custom styling to individual components.
 tags: [occt, assembly, step, gltf, cad]
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import BitByBitRenderCanvas from '@site/src/components/BitByBitRenderCanvas';
 
-# OCCT Assembly Structure
+# Navigate and Extract Assembly Parts
 
 <img 
   class="category-icon-small" 
   src="https://s.bitbybit.dev/assets/icons/white/occt-icon.svg" 
   alt="OCCT category icon with a stylized logo representation" 
   title="OCCT category icon" />
 
-Understanding assembly structure is essential when working with CAD models. Think of an assembly like a family tree for 3D parts - it shows how different components are organized and related to each other. Let's explore how to navigate this structure and extract the parts you need.
+When you need to access individual parts from a STEP file, understanding the assembly structure is key. This tutorial shows you how to explore the hierarchy, find specific parts using their labels, and render them with custom colors.
 
-## What is Assembly Structure?
+## How the Hierarchy Works
 
-When engineers design complex products (like machines, robots, or buildings), they don't create one giant 3D shape. Instead, they build **assemblies** - collections of individual parts organized in a hierarchy. Each part has:
+Assemblies organize parts in a tree structure. Each part has:
 
 - A **label** (like an address): `0:1:1:3` tells you exactly where the part lives in the structure
 - A **name**: Human-readable identifier like "Mounting Plate" or "Screw"

docs/learn/code/common/occt/assembly/create-assembly.mdx

@@ -1,28 +1,28 @@
 ---
-sidebar_position: 4
-title: "Create Assembly"
+sidebar_position: 5
+title: "Build and Export Assemblies"
 sidebar_label: Creating Assembly
-description: Learn how to create OCCT assembly documents with parts, instances, and hierarchies. Export structured STEP files compatible with FreeCAD, Fusion 360, SolidWorks, and other CAD software.
+description: Create structured CAD assemblies with parts, instances, and hierarchies. Export STEP files compatible with FreeCAD, Fusion 360, and SolidWorks.
 tags: [occt, assembly, step, gltf, cad]
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import BitByBitRenderCanvas from '@site/src/components/BitByBitRenderCanvas';
 
-# OCCT Assembly Structure
+# Build Multi-Part Assemblies from Scratch
 
 <img 
   class="category-icon-small" 
   src="https://s.bitbybit.dev/assets/icons/white/occt-icon.svg" 
   alt="OCCT category icon with a stylized logo representation" 
   title="OCCT category icon" />
 
-## What is an Assembly Document?
+This tutorial demonstrates how to create an assembly programmatically using parts and instances, then export it as a structured STEP file.
 
-An **assembly document** is a structured CAD file format that organizes your 3D model into a hierarchy of **parts** and **instances**. Unlike a flat shape export where all geometry is merged into a single blob, an assembly preserves the logical structure of your design.
+## Parts, Instances, and Nodes
 
-Think of it like building a car:
+An **assembly document** organizes your 3D model into a hierarchy:
 - **Parts** are the unique component designs (e.g., a wheel, a door, an engine)
 - **Instances** are the actual placements of those parts in your model (e.g., "put a wheel at each corner of the chassis")
 - **Assembly nodes** are containers that group related instances together (e.g., "the drivetrain" containing engine and transmission)

docs/learn/code/common/occt/assembly/intro.mdx

@@ -1,8 +1,8 @@
 ---
 sidebar_position: 1
-title: "Intro OCCT Assemblies"
+title: "Introduction to Assemblies"
 sidebar_label: Introduction
-description: Learn how to work with OCCT assemblies in Bitbybit - load STEP files, convert CAD data to glTF for web display, parse assembly structure, and build interactive 3D CAD viewers with examples in Rete, Blockly, and TypeScript.
+description: Understand what OCCT assemblies are, why STEP files matter for CAD workflows, and preview your first assembly model in the browser.
 tags: [occt, assembly, step, gltf, cad]
 ---
 

docs/learn/code/common/occt/assembly/shape-to-step-with-color-assembly.mdx

@@ -1,26 +1,28 @@
 ---
 sidebar_position: 4
-title: "Shape With Color to STEP"
-sidebar_label: Shape with color to STEP
-description: Learn
+title: "Export Shapes with Color"
+sidebar_label: Shape with Color to STEP
+description: Export OCCT shapes to STEP files with preserved colors using the assembly document structure for CAD software compatibility.
 tags: [occt, assembly, step, gltf, cad]
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import BitByBitRenderCanvas from '@site/src/components/BitByBitRenderCanvas';
 
-# OCCT Assembly Structure
+# Preserve Colors in STEP Exports
 
 <img 
   class="category-icon-small" 
   src="https://s.bitbybit.dev/assets/icons/white/occt-icon.svg" 
   alt="OCCT category icon with a stylized logo representation" 
   title="OCCT category icon" />
 
-## Preserving Colors
+Standard STEP files store only geometry — no color information. To preserve colors, you need to use the assembly document structure. This was one of our most requested features, and it's finally available!
 
-In order to preserve colors in your STEP files, you have to use assemblies. While fundamental, this was always one of the most requested features of our users, but it required full Assembly support in order to function properly. It's nice that it finally arrived.
+## Why Colors Require Assemblies
+
+The XCAF (Extended CAD Application Framework) format used by OCCT can embed colors into assembly structures. By wrapping shapes in an assembly with color-assigned instances, you ensure colors transfer correctly to other CAD applications.
 
 ## What These Scripts Do
 

docs/learn/code/common/occt/assembly/step-to-gltf.mdx

@@ -1,35 +1,28 @@
 ---
 sidebar_position: 2
-title: "STEP to GLTF"
+title: "Convert STEP to GLTF"
 sidebar_label: STEP to GLTF
-description: While displaying GLTF model is very useful, you can use Bitbybit browser based algorithms for conversions too. In this tutorial you'll learn how to do that.
+description: Convert STEP files to web-optimized GLTF/GLB format directly in the browser with privacy-preserving local processing.
 tags: [occt, assembly, step, gltf, cad]
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import BitByBitRenderCanvas from '@site/src/components/BitByBitRenderCanvas';
 
-# Exporting GLTF files produced from STEP files
+# Export STEP Files to GLTF
 
 <img 
   class="category-icon-small" 
   src="https://s.bitbybit.dev/assets/icons/white/occt-icon.svg" 
   alt="OCCT category icon with a stylized logo representation" 
   title="OCCT category icon" />
 
-Converting STEP files to GLTF is one of the most practical operations you can perform with CAD data. This tutorial shows you how to transform engineering CAD files into web-friendly 3D formats - all running directly in your browser!
+This tutorial shows you how to convert STEP files to web-optimized GLTF/GLB format — with all processing happening directly in your browser.
 
-## Why Convert STEP to GLTF?
+## Why Export to GLTF?
 
-**STEP files** are the gold standard for exchanging CAD data between professional engineering software. They preserve exact geometry, assembly structure, colors, and metadata. However, they're not designed for web viewing.
-
-**GLTF (GL Transmission Format)** is the "JPEG of 3D" - a lightweight, web-optimized format that loads quickly in browsers, game engines, and 3D viewers. The binary version (**.glb**) packages everything into a single file.
-
-By converting STEP to GLTF, you get the best of both worlds:
-- ✅ Start with precise engineering data
-- ✅ End with a fast-loading web-ready model
-- ✅ Preserve colors and structure from the original CAD file
+STEP files preserve precise CAD geometry but aren't optimized for web viewing. GLTF (the "JPEG of 3D") loads quickly in browsers and 3D engines while preserving colors and structure from the original file.
 
 ## Browser-Based Conversion