Merge branch 'main' into patch-5

Author: sammygrey

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

@@ -9,6 +9,8 @@ description: |
   `Class.AudioAnalyzer` takes measurements from audio streams that are wired to
   it through `Class.Wire`. It provides a single **Input** pin but does not
   produce any output streams.
+  Note that all audio processing is disabled on the server in order to conserve resources;
+  Properties and methods of `Class.AudioAnalyzer` return empty or zero results when used from server scripts.
 code_samples: []
 inherits:
   - Instance
@@ -20,7 +22,8 @@ properties:
       The loudest volume observed during the last audio buffer.
     description: |
       The loudest volume observed during the last audio buffer. This property
-      changes often and thus does not fire changed events.
+      changes more often than the framerate and does not fire changed events.
+      On the server, this property is always `0`.
     code_samples: []
     type: float
     tags:
@@ -46,6 +49,8 @@ properties:
       This property is generally more stable than
       `Class.AudioAnalyzer.PeakLevel|PeakLevel` but it may not capture momentary
       volume spikes.
+      This property changes more often than the framerate and does not fire changed events.
+      On the server, this property is always `0`.
     code_samples: []
     type: float
     tags:
@@ -116,8 +121,9 @@ methods:
     description: |
       Returns the frequency spectrum of the last audio buffer, as an array of
       numbers. The elements of the array are root-mean-square volume levels,
-      evenly spaced from 0 hertz to 24,000 hertz. If any of the analyzer's
-      inputs come from an `Class.AudioDeviceInput`, this method returns an empty
+      evenly spaced from 0 hertz to 24,000 hertz.
+      If any of the analyzer's
+      inputs come from an `Class.AudioDeviceInput`, or this method is used from a server script, it returns an empty
       array.
     code_samples: []
     parameters: []

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

@@ -59,7 +59,7 @@ properties:
       Color of the text in the chat window.
     description: |
       Determines the color of the text in the chat window. Default value is
-      `Datatype.Color3.new(255, 255, 255)` (white).
+      `Datatype.Color3.fromRGB(255, 255, 255)` (white).
     code_samples: []
     type: Color3
     tags: []
@@ -100,7 +100,7 @@ properties:
       Stroke color applied to text in the chat window.
     description: |
       Determines the stroke color applied to text in the chat window. Default
-      value is `Datatype.Color3.new(0, 0, 0)` (black).
+      value is `Datatype.Color3.fromRGB(0, 0, 0)` (black).
     code_samples: []
     type: Color3
     tags: []

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

@@ -1167,7 +1167,7 @@ events:
     summary: |
       Fires when a purchase prompt for a developer product is closed. Do not use this event to process purchases.
     description: |
-      ##### Do not use the `PromptProductPurchaseFinished` event to process purchases; instead, use the `Class.MarketplaceService.ProcessReceipt|ProcessReceipt` callback. The firing of `PromptProductPurchaseFinished` does NOT mean that a user has successfully purchased an item.
+      **IMPORTANT:** Do **not** use the `PromptProductPurchaseFinished` event to process purchases; instead, use the `Class.MarketplaceService.ProcessReceipt|ProcessReceipt` callback. The firing of `PromptProductPurchaseFinished` does **not** mean that a user has successfully purchased an item.
 
       This event fires when a purchase prompt for a [developer product](../../../production/monetization/developer-products.md) closes. For example, when a user receives the purchase prompt and clicks **Cancel**, or when they receive a success or error message and click **OK**. The firing of this event does **not** mean that a user has successfully purchased an item.
 
@@ -1285,8 +1285,8 @@ callbacks:
     summary: |
       A callback to process receipts of developer product purchases.
     description: |
-      ##### We **highly recommend** that you properly implement the `ProcessReceipt` callback in order to sell your developer products. You should use `ProcessReceipt` to grant users their purchased product over any other granting method. If your `ProcessReceipt` implementation isn't correct, you will NOT be able to grant users the products they have purchased on the Experience Detail page.
-
+      **IMPORTANT:** We **highly recommend** that you properly implement the `ProcessReceipt` callback in order to sell your developer products. You should use `ProcessReceipt` to grant users their purchased product over any other granting method. If your `ProcessReceipt` implementation isn't correct, you will **not** be able to grant users the products they have purchased on the Experience Detail page.
+      
       A callback to process receipts from [developer product](../../../production/monetization/developer-products.md) purchases. You can sell developer products inside an experience using `MarketplaceService` functions, or outside an experience on the Experience Detail page.
 
       You should only set the `ProcessReceipt` callback one time in a single server-side `Class.Script|Script`. This callback must handle the receipts for all developer products you have for sale.
@@ -1345,12 +1345,6 @@ callbacks:
             transaction.
           - `CurrencyType` — The type of currency spent in the purchase;
             always `Enum.CurrencyType.Robux`.
-          - `ProductPurchaseChannel` — An enum that represents how the user acquired the developer product.
-
-            - `InExperience`: The purchase was made inside of an experience.
-            - `ExperienceDetailsPage`: The purchase was made outside of an experience, on the Experience Details page.
-            - `AdReward`: The product was rewarded to the user when they watched a video ad to completion.
-            - `CommerceProduct`: The user acquired the product as a benefit of purchasing a commerce merchandise from the developer of the experience.
     returns:
       - type: ProductPurchaseDecision
         summary: |

content/en-us/studio/shortcuts.md

@@ -31,8 +31,8 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
     <tr>
       <td>**Open from Roblox...**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>O</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>O</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>O</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>O</kbd></td>
       <td>Open a recent experience from Roblox.</td>
     </tr>
     <tr>
@@ -43,8 +43,8 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
     <tr>
       <td>**Save to File As...**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>S</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>S</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>S</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>S</kbd></td>
       <td>Save the active local file with a new name.</td>
     </tr>
 		<tr>
@@ -73,8 +73,8 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
 		<tr>
       <td>**Open Previous Tab**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>T</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>T</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>T</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>T</kbd></td>
       <td>Open the previous tab.</td>
     </tr>
     <tr>
@@ -177,8 +177,8 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
 		<tr>
       <td>**Paste Into**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>V</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>V</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>V</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>V</kbd></td>
       <td>Paste the objects currently on the clipboard as children of the selected object.</td>
     </tr>
 		<tr>
@@ -225,8 +225,8 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
     <tr>
       <td>**Redo**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>Z</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>Z</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>Z</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>Z</kbd></td>
       <td>Redo the previously undone action.</td>
     </tr>
   </tbody>
@@ -323,26 +323,26 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
     <tr>
       <td>**Union**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>G</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>G</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>G</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>G</kbd></td>
       <td>Join two or more parts together to form a single solid union; see [Solid Modeling](../parts/solid-modeling.md) for details.</td>
     </tr>
 		<tr>
       <td>**Intersect**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>I</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>I</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>I</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>I</kbd></td>
       <td>Intersect overlapping parts into a single solid intersection; see [Solid Modeling](../parts/solid-modeling.md) for details.</td>
     </tr>
     <tr>
       <td>**Negate**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>N</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>N</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>N</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>N</kbd></td>
       <td>Negate parts, useful for making holes and indentations; see [Solid Modeling](../parts/solid-modeling.md) for details.</td>
     </tr>
     <tr>
       <td>**Separate**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>U</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>U</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>U</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>U</kbd></td>
       <td>Separate the union or intersection back into its individual parts; see [Solid Modeling](../parts/solid-modeling.md) for details.</td>
     </tr>
   </tbody>
@@ -402,14 +402,14 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
     <tr>
       <td>**Explorer Filter**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>X</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>X</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>X</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>X</kbd></td>
       <td>Jump to the [Explorer](../studio/explorer.md) window filter input field.</td>
     </tr>
     <tr>
       <td>**Properties Filter**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>P</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>P</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>P</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>P</kbd></td>
       <td>Jump to the [Properties](../studio/properties.md) window filter input field.</td>
     </tr>
     <tr>
@@ -495,38 +495,38 @@ Studio has many default shortcuts and key commands that make development quicker
     </tr>
 		<tr>
       <td>**Save and Reload Plugins in Debugger**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>L</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>L</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>L</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>L</kbd></td>
       <td>Save all plugins in debugger back to disk, stop execution of those plugins, and reload them from disk.</td>
     </tr>
     <tr>
       <td>**Stats**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>F1</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>F1</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>F1</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>F1</kbd></td>
       <td>Show detailed experience stats.</td>
     </tr>
     <tr>
       <td>**Render**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>F2</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>F2</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>F2</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>F2</kbd></td>
       <td>Show detailed graphics and performance data.</td>
     </tr>
     <tr>
       <td>**Network**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>F3</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>F3</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>F3</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>F3</kbd></td>
       <td>Show detailed network stats. Once open, pressing <kbd>Shift</kbd><kbd>1</kbd> cycles through additional panels of data.</td>
     </tr>
     <tr>
       <td>**Physics**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>F4</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>F4</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>F4</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>F4</kbd></td>
       <td>Show detailed physics data.</td>
     </tr>
     <tr>
       <td>**Summary**</td>
-			<td><kbd>Shift</kbd><kbd>Ctrl</kbd><kbd>F5</kbd></td>
-			<td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>F5</kbd></td>
+			<td><kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>F5</kbd></td>
+			<td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>F5</kbd></td>
       <td>Show a summary of stats data.</td>
     </tr>
   </tbody>
@@ -616,7 +616,7 @@ Studio has many default shortcuts and key commands that make development quicker
     <tr>
       <td>**Redo**</td>
       <td><kbd>Ctrl</kbd><kbd>Y</kbd></td>
-      <td><kbd>Shift</kbd><kbd>⌘</kbd><kbd>Z</kbd></td>
+      <td><kbd>⌘</kbd><kbd>Shift</kbd><kbd>Z</kbd></td>
     </tr>
     <tr>
       <td>**Select All**</td>