update rules

.cursor/rules/roblox/en-us/workspace/index.md

@@ -0,0 +1,116 @@
+---
+title: 3D workspace
+description: Describes the workspace container service, which holds all objects that exist in the 3D world.
+---
+
+`Class.Workspace` is a container service that holds objects that you want the
+Roblox Engine to render in the 3D world. You typically will add these objects to
+the workspace:
+
+- `Class.BasePart` objects, which includes both `Class.Part` and `Class.MeshPart` objects.
+- `Class.Attachment` objects, which you can attach to special effect generators like a `Class.ParticleEmitter`, UI objects like a `Class.BillboardGui`, physical `Class.Constraint|Constraints`, and more.
+- `Class.Model` objects that organize geometric groupings.
+- `Class.Script` objects that are parented by other objects in the workspace.
+  Scripts aren't rendered but can affect another object's rendering.
+
+## Parts
+
+`Class.Part` objects represent the primitive building blocks in Roblox. By default, all parts have their physics simulated and are rendered if they appear in the 3D workspace. Parts can take the shape of blocks, spheres, cylinders, wedges, or corner wedges. In addition, `Class.TrussPart` acts as a truss beam that characters can climb like a ladder.
+
+<Grid container spacing={1}>
+<Grid item XSmall={4} XLarge={2}>
+	<figure>
+	<img src="../assets/modeling/parts/Basic-Part-Block.png" alt="A single Block part." />
+	<figcaption><center>Block</center></figcaption>
+	</figure>
+</Grid>
+<Grid item XSmall={4} XLarge={2}>
+	<figure>
+	<img src="../assets/modeling/parts/Basic-Part-Sphere.png" alt="A single Sphere part." />
+	<figcaption><center>Sphere</center></figcaption>
+	</figure>
+</Grid>
+<Grid item XSmall={4} XLarge={2}>
+	<figure>
+	<img src="../assets/modeling/parts/Basic-Part-Cylinder.png" alt="A single Cylinder part." />
+	<figcaption><center>Cylinder</center></figcaption>
+	</figure>
+</Grid>
+<Grid item XSmall={4} XLarge={2}>
+	<figure>
+	<img src="../assets/modeling/parts/Basic-Part-Wedge.png" alt="A single Wedge part." />
+	<figcaption><center>Wedge</center></figcaption>
+	</figure>
+</Grid>
+<Grid item XSmall={4} XLarge={2}>
+	<figure>
+	<img src="../assets/modeling/parts/Basic-Part-Corner-Wedge.png" alt="A single Corner Wedge part." />
+	<figcaption><center>Corner Wedge</center></figcaption>
+	</figure>
+</Grid>
+</Grid>
+
+You can also apply [solid modeling](../parts/solid-modeling.md) operations to parts, such as union or negate, to combine them into something more complex like bowls or hollow pipes.
+
+## Meshes
+
+A `Class.MeshPart` is an object that represents a mesh (a collection of
+vertices, edges, and faces that make up a 3D object). You typically create
+meshes using third-party software such as [Blender](https://www.blender.org) or [Maya](https://www.autodesk.com/products/maya/overview),
+then import them as a `Class.MeshPart` using Studio.
+
+Meshes can include far more detail than any solid modeling you can do in
+Studio. They can also have internal rigs and textures, allowing you to
+create lifelike objects that you can pose and animate.
+
+<GridContainer numColumns="2">
+  <figure>
+    <img src="../assets/modeling/meshes/Mesh-Textured.jpg" alt="A high-quality treasure chest mesh with a texture." />
+    <figcaption>Mesh with texture</figcaption>
+  </figure>
+  <figure>
+    <img src="../assets/modeling/meshes/Mesh-SurfaceAppearance.jpg" alt="A realistic looking leafy bush with shadows and depth."/>
+    <figcaption>Mesh with SurfaceAppearance</figcaption>
+  </figure>
+</GridContainer>
+
+## Terrain
+
+The `Class.Terrain` object allows you to generate and sculpt detailed and realistic terrain environments, such as mountains, bodies of water, grass-covered hills, or a flat desert. Using the [Terrain Editor](../studio/terrain-editor.md), you can easily generate and alter large regions of terrain.
+
+<img src="../assets/modeling/terrain/Showcase.jpg" width="100%" alt="A viewport view of desert terrain with mountains in the distance." />
+
+## Models
+
+A `Class.Model` is a container object for **geometric groupings**, such as
+`Class.BasePart`, `Class.Motor6D` objects, and other models. Models can be simple
+groupings or you can set a primary part within the model, so that it functions as
+an assembly, which the physics engine treats as a single rigid body. Models can
+also contain scripts that act on the individual objects of the model.
+
+<GridContainer numColumns="2">
+	<figure>
+		<img src="../assets/modeling/model-objects/Model-Example-3D.jpg" alt="A humanoid model of a creepy girl with four red eyes standing in an A pose. She wears a maroon dress with webs and bright red stockings." />
+		<figcaption>A model named Octavia</figcaption>
+	</figure>
+	<figure>
+    	<img src="../assets/modeling/model-objects/Model-Example-Hierarchy.png" width="320" alt="A close up view of the model's children in the Explorer window that comprise the model." />
+    	<figcaption>The groupings that comprise the model</figcaption>
+    </figure>
+</GridContainer>
+
+## Workspace access in scripts
+
+Within a script, you can access a place's `Class.Workspace` in three different ways, all of which are valid.
+
+- `game:GetService("Workspace")`
+- `workspace`
+- `game.Workspace`
+
+From there, you can carry out a large set of use cases to script logic for your
+experiences and create dynamic worlds and interactions. For example:
+
+- Obtain a reference to any object in the workspace to change its properties during runtime.
+- Obtain a reference to a user's `Class.Camera` object to [manipulate their view](../workspace/camera.md) of the workspace.
+- Listen for events on objects in the workspace to carry out
+  logic at specific times, such as when a user's playable character [touches an object](../workspace/collisions.md).