update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/en-us/art/modeling/surface-appearance.md

@@ -218,6 +218,12 @@ The following example demonstrates how a partial and full transparency in this m
 </TabItem>
 </Tabs>
 
+There are two outcomes of `Enum.AlphaMode|Transparency` mode, depending on whether the `Class.MeshPart.Transparency` is set to `0` or **at&nbsp;least** `0.02`, although numerical precision may result in small values such as `0.01` triggering the opaque transparency.
+
+- When alpha is used to cut out the shape of mostly opaque objects with hard edges such as foliage, lace fabric, and netting, set the `Class.MeshPart.Transparency` to `0`. When parts of the surface are fully opaque, the Roblox engine can render them with proper depth‑based occlusion. Opaque surfaces also generally work better with depth‑based effects like `Class.DepthOfFieldEffect`, glass and water refraction, and water reflection.
+
+- When alpha is used to add detail to semi‑transparent objects or objects with smooth gradients of transparency, set the `Class.MeshPart.Transparency` to **at&nbsp;least** `0.02`. This improves the quality of blending for objects such as dirty windows and soft‑edged feathers, but it will not work with all effects.
+
 #### Color tinting
 
 You can apply a tint to your color map by modifying the `Class.SurfaceAppearance.Color` property. Tinting does not affect performance and you can save on memory by reusing a single ColorMap with different tints. Use color tinting to create additional low-cost variation between your `Class.MeshPart` PBR textures or to programmatically modify your PBR surface colors in real-time.

content/en-us/assets/monetization/avatar-items/avatar-item-analytics-3.png

@@ -64,5 +64,8 @@ The analytics tab enables you to:
 - **View top performing items:** See your top selling and top grossing Avatar Items over a selected time period.
 - **Analyze overall sales and net revenue:** Showcase up to eight top items on a time-series graph.
 - **Monitor your catalog:** Examine a table with up to 400 items, sortable by sales and net revenue.
+- **View buyer demographics:** See the demographic information of buyers, including age, gender, location, and platform.
 
 <img src="../../assets/monetization/avatar-items/avatar-items-analytics-2.png" width="100%" />
+
+<img src="../../assets/monetization/avatar-items/avatar-item-analytics-3.png" width="100%" />

content/en-us/production/monetization/avatar-items.md

@@ -207,8 +207,17 @@ properties:
     capabilities: []
     writeCapabilities: []
   - name: DataModel.MatchmakingType
-    summary: ''
-    description: ''
+    summary: |
+      Represents how players in the server are handled by matchmaking.
+    description: |
+      This property represents how players in the server are handled by
+      matchmaking. Players with different
+      `Class.DataModel.MatchmakingType|MatchmakingTypes` cannot be in or
+      teleport to the same server.
+      
+      Note that this property is only valid on the server `Class.DataModel` and
+      it will be the `Enum.MatchmakingType.Default` value for all clients, so
+      only reference this property inside of a server‑side `Class.Script`.
     code_samples: []
     type: MatchmakingType
     tags:

content/en-us/reference/engine/classes/DataModel.yaml

@@ -40,15 +40,15 @@ properties:
       This property determines how the alpha channel of the
       `Class.SurfaceAppearance.ColorMap` is used.
 
-      When set to `Enum.AlphaMode|Transparency` and the
-      `Class.BasePart.Transparency|MeshPart.Transparency` is set to 0, opaque
-      pixels in the `Class.SurfaceAppearance.ColorMap` will render as completely
-      opaque in the 3D scene. This solves various problems for textures with
-      different transparent and opaque areas, such as foliage. When parts of the
-      surface are fully opaque, the Roblox Engine can render them with proper
-      depth-based occlusion. Opaque surfaces also generally work better with
-      depth-based effects like `Class.DepthOfFieldEffect`, glass and water
-      refraction, and water reflection.
+      When set to `Enum.AlphaMode|Transparency` and the `Class.MeshPart.Transparency`
+      is set to `0`, opaque pixels in the `Class.SurfaceAppearance.ColorMap|ColorMap` will
+      render as completely opaque in the 3D scene. This combination works better with
+      depth-based effects and occlusion.
+      
+      When set to `Enum.AlphaMode|Transparency` and the `Class.MeshPart.Transparency`
+      is set to at least `0.02`, a different blending method is used that can better
+      represent smooth transparency gradients and soft edges. This combination does not
+      support all effects and occlusion may not be perfect.
 
       See [here](../../../art/modeling/surface-appearance.md#alpha-modes) for
       more information.

content/en-us/reference/engine/classes/SurfaceAppearance.yaml

@@ -677,9 +677,11 @@ methods:
 
       #### Cross-Platform Play
 
-      Players on Xbox One with cross-platform play disabled will arrive in a
-      different server with players with cross-platform play enabled. This can
-      cause multiple game servers with the same PrivateServerId to exist.
+      Players on Xbox and PlayStation with cross‑play disabled will
+      arrive in a different server than players with cross‑play
+      enabled. This can cause multiple game servers with the same
+      `Class.DataModel.PrivateServerId|PrivateServerId` to exist. You can use
+      `Class.DataModel.MatchmakingType` to differentiate these game servers.
     code_samples:
       - TeleportService-ReserveServer1
       - teleportservice-teleport-to-a-reserved-server-via-chat

content/en-us/reference/engine/classes/TeleportService.yaml

@@ -1,23 +1,30 @@
 name: MatchmakingType
 type: enum
-summary: ''
-description: ''
+summary: |
+  Used with `Class.DataModel.MatchmakingType` to represent how players in the
+  server are handled by matchmaking.
+description: |
+  This enum is used with `Class.DataModel.MatchmakingType` to represent how
+  players in the server are handled by matchmaking.
 code_samples: []
 tags: []
 deprecation_message: ''
 items:
   - name: Default
-    summary: ''
+    summary: |
+      Includes desktop, mobile, cross-play enabled players, etc.
     value: 1
     tags: []
     deprecation_message: ''
   - name: XboxOnly
-    summary: ''
+    summary: |
+      Xbox players with cross-play disabled.
     value: 2
     tags: []
     deprecation_message: ''
   - name: PlayStationOnly
-    summary: ''
+    summary: |
+      PlayStation players with cross-play disabled.
     value: 3
     tags: []
     deprecation_message: ''