update Open Source Docs from Roblox internal teams

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

content/common/navigation/engine/guides.yaml

@@ -337,6 +337,16 @@ navigation:
         path: /audio/objects
       - title: Effects
         path: /audio/effects
+      - title: Legacy
+        section:
+          - title: Sound
+            path: /sound/index
+          - title: Objects
+            path: /sound/objects
+          - title: Groups
+            path: /sound/groups
+          - title: Dynamic Effects
+            path: /sound/dynamic-effects
   - title: User interface
     path: /ui/
     section:

content/common/navigation/engine/reference.yaml

@@ -1108,11 +1108,6 @@ navigation:
         type: engineapi
         source: /reference/engine/classes/Glue.yaml
         ignoreTranslation: true
-      - title: GoogleAnalyticsConfiguration
-        path: /reference/engine/classes/GoogleAnalyticsConfiguration
-        type: engineapi
-        source: /reference/engine/classes/GoogleAnalyticsConfiguration.yaml
-        ignoreTranslation: true
       - title: GroundController
         path: /reference/engine/classes/GroundController
         type: engineapi
@@ -3751,6 +3746,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/CameraType.yaml
         ignoreTranslation: true
+      - title: CaptureType
+        path: /reference/engine/enums/CaptureType
+        type: engineapi
+        source: /reference/engine/enums/CaptureType.yaml
+        ignoreTranslation: true
       - title: CatalogCategoryFilter
         path: /reference/engine/enums/CatalogCategoryFilter
         type: engineapi

content/en-us/audio/objects.md

@@ -1,6 +1,6 @@
 ---
 title: Audio objects
-description: An overview of audio object on Roblox.
+description: An overview of modular audio objects on Roblox.
 ---
 
 Roblox's modular audio objects allow you to have dynamic control over sound and voice chat in your experiences. Almost every audio object corresponds to a real-world audio device, and they all function together to capture and play audio like their physical counterparts.
@@ -15,7 +15,7 @@ For example, every audio object conceptually falls into the following categories
 As you read through this guide and learn about how all of these audio objects work together to emit sound, you will learn how to accurately capture and feed music, sound effects, and the human voice from the experience to the player and vice-versa.
 
 <Alert severity = 'info'>
-`Class.Sound`, `Class.SoundGroup`, and `Class.SoundEffect` objects are now deprecated in favor of the more robust functionality of audio objects.
+`Class.Sound`, `Class.SoundGroup`, and `Class.SoundEffect` objects are now discouraged in favor of the more robust functionality of audio objects.
 </Alert>
 
 ## Play audio

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

@@ -72,24 +72,6 @@ methods:
     thread_safety: Unsafe
     capabilities: []
     writeCapabilities: []
-  - name: AssetService:CreateSurfaceAppearance
-    summary: ''
-    description: ''
-    code_samples: []
-    parameters:
-      - name: content
-        type: Dictionary
-        default: ''
-        summary: ''
-    returns:
-      - type: SurfaceAppearance
-        summary: ''
-    tags: []
-    deprecation_message: ''
-    security: None
-    thread_safety: Unsafe
-    capabilities: []
-    writeCapabilities: []
   - name: AssetService:CreateAssetAsync
     summary: |
       Uploads a new asset to Roblox from the given object.

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

@@ -16,7 +16,8 @@ code_samples:
   - audio-wiring---splitting-mixing
 inherits:
   - Instance
-tags: []
+tags:
+  - NotBrowsable
 deprecation_message: ''
 properties:
   - name: AudioChannelMixer.Layout

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

@@ -18,7 +18,8 @@ code_samples:
   - audio-wiring---splitting-mixing
 inherits:
   - Instance
-tags: []
+tags:
+  - NotBrowsable
 deprecation_message: ''
 properties:
   - name: AudioChannelSplitter.Layout

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

@@ -4,12 +4,13 @@ memory_category: Internal
 summary: |
   Records audio streams in-experience.
 description: |
-  `AudioRecorder` records audio streams in-experience with a fixed time limit of 60 seconds. The
-  results can be loaded into an `Class.AudioPlayer` for playback.
+  `AudioRecorder` records audio streams in-experience with a fixed time limit of
+  60 seconds. The results can be loaded into an `Class.AudioPlayer` for
+  playback.
 
   At this time, `Class.AudioDeviceInput` cannot be recorded. The
-  `Class.AudioRecorder.GetUnrecordableInstancesAsync()|GetUnrecordableInstancesAsync()` method
-  can be used to check specifically which instances aren't recordable.
+  `Class.AudioRecorder.GetUnrecordableInstancesAsync()|GetUnrecordableInstancesAsync()`
+  method can be used to check specifically which instances aren't recordable.
 code_samples: []
 inherits:
   - Instance
@@ -127,7 +128,8 @@ methods:
     summary: ''
     description: |
       Returns recorded content that can be played back with `Class.AudioPlayer`.
-      The content retrieved from this method is only valid in the current session.
+      The content retrieved from this method is only valid in the current
+      session.
     code_samples: []
     parameters: []
     returns:
@@ -159,8 +161,9 @@ methods:
   - name: AudioRecorder:CanRecordAsync
     summary: ''
     description: |
-      Returns whether the `AudioRecorder` can currently record. For instance, this will return `false`
-      if the current recording data has reached the recording time limit. To clear the recording, use
+      Returns whether the `AudioRecorder` can currently record. For instance,
+      this will return `false` if the current recording data has reached the
+      recording time limit. To clear the recording, use
       `Class.AudioRecorder:Clear()|Clear()`.
     code_samples: []
     parameters: []
@@ -178,8 +181,9 @@ methods:
   - name: AudioRecorder:GetUnrecordableInstancesAsync
     summary: ''
     description: |
-      Traverses the audio graph, starting from this recorder's inputs, to find unrecordable instances.
-      Currently, `Class.AudioDeviceInput` is not recordable.
+      Traverses the audio graph, starting from this recorder's inputs, to find
+      unrecordable instances. Currently, `Class.AudioDeviceInput` is not
+      recordable.
     code_samples: []
     parameters: []
     returns:
@@ -196,8 +200,9 @@ methods:
   - name: AudioRecorder:RecordAsync
     summary: ''
     description: |
-      If `Class.AudioRecorder:CanRecordAsync()|CanRecordAsync()` returns `true`, recording begins.
-      If recording cannot begin, this method produces an error.
+      If `Class.AudioRecorder:CanRecordAsync()|CanRecordAsync()` returns `true`,
+      recording begins. If recording cannot begin, this method produces an
+      error.
     code_samples: []
     parameters: []
     returns:

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

@@ -169,25 +169,6 @@ methods:
     thread_safety: Unsafe
     capabilities: []
     writeCapabilities: []
-  - name: AvatarCreationService:GenerateAvatar2DPreviewAsync
-    summary: ''
-    description: ''
-    code_samples: []
-    parameters:
-      - name: avatarGeneration2dPreviewParams
-        type: Dictionary
-        default: ''
-        summary: ''
-    returns:
-      - type: string
-        summary: ''
-    tags:
-      - Yields
-    deprecation_message: ''
-    security: None
-    thread_safety: Unsafe
-    capabilities: []
-    writeCapabilities: []
   - name: AvatarCreationService:GetBatchTokenDetailsAsync
     summary: |
       Gets the avatar creation token details for a list of avatar creation
@@ -232,44 +213,6 @@ methods:
     thread_safety: Unsafe
     capabilities: []
     writeCapabilities: []
-  - name: AvatarCreationService:LoadAvatar2DPreviewAsync
-    summary: ''
-    description: ''
-    code_samples: []
-    parameters:
-      - name: previewId
-        type: string
-        default: ''
-        summary: ''
-    returns:
-      - type: EditableImage
-        summary: ''
-    tags:
-      - Yields
-    deprecation_message: ''
-    security: None
-    thread_safety: Unsafe
-    capabilities: []
-    writeCapabilities: []
-  - name: AvatarCreationService:LoadGeneratedAvatarAsync
-    summary: ''
-    description: ''
-    code_samples: []
-    parameters:
-      - name: generationId
-        type: string
-        default: ''
-        summary: ''
-    returns:
-      - type: HumanoidDescription
-        summary: ''
-    tags:
-      - Yields
-    deprecation_message: ''
-    security: None
-    thread_safety: Unsafe
-    capabilities: []
-    writeCapabilities: []
   - name: AvatarCreationService:PrepareAvatarForPreviewAsync
     summary: ''
     description: ''

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

@@ -201,7 +201,11 @@ events:
       used to customize the capture experience, for example by hiding certain
       GUI elements.
     code_samples: []
-    parameters: []
+    parameters:
+      - name: captureType
+        type: CaptureType
+        default: ''
+        summary: ''
     tags: []
     deprecation_message: ''
     security: None
@@ -215,7 +219,11 @@ events:
       to restore any changes made when the
       `Class.CaptureService.CaptureBegan|CaptureBegan` event fired.
     code_samples: []
-    parameters: []
+    parameters:
+      - name: captureType
+        type: CaptureType
+        default: ''
+        summary: ''
     tags: []
     deprecation_message: ''
     security: None

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

@@ -1,8 +1,13 @@
 name: CommerceService
 type: class
 memory_category: Instances
-summary: 'Supports real-world purchases that you can bundle with digital benefits.'
-description: '`Class.CommerceService` is a service that supports real-world purchases that you can bundle with virtual items. For information on eligibility and implementation, see [Commerce products](../../../production/monetization/commerce-products.md).'
+summary: |
+  Supports real-world purchases that you can bundle with digital benefits.
+description: |
+  `Class.CommerceService` is a service that supports real-world purchases that
+  you can bundle with virtual items. For information on eligibility and
+  implementation, see
+  [Commerce products](../../../production/monetization/commerce-products.md).
 code_samples: []
 inherits:
   - Instance
@@ -13,8 +18,14 @@ deprecation_message: ''
 properties: []
 methods:
   - name: CommerceService:PromptCommerceProductPurchase
-    summary: 'Prompts a user to purchase a commerce product using the provided `commerceProductId`. Opens a webview that guides the user through the purchasing flow.'
-    description: 'Prompts a user to purchase a commerce product using the provided `commerceProductId`. Opens a webview that guides the user through the purchasing flow.'
+    summary: |
+      Prompts a user to purchase a commerce product using the provided
+      `commerceProductId`. Opens a webview that guides the user through the
+      purchasing flow.
+    description: |
+      Prompts a user to purchase a commerce product using the provided
+      `commerceProductId`. Opens a webview that guides the user through the
+      purchasing flow.
     code_samples: []
     parameters:
       - name: user
@@ -36,7 +47,12 @@ methods:
     writeCapabilities: []
   - name: CommerceService:PromptRealWorldCommerceBrowser
     summary: ''
-    description: 'This is a legacy endpoint that is not meant for use. To open the webview to the purchasing flow for real world commerce, see `Class.CommerceService:PromptCommerceProductPurchase`. For more information, see [Commerce products](../../../production/monetization/commerce-products.md)'
+    description: |
+      This is a legacy endpoint that is not meant for use. To open the webview
+      to the purchasing flow for real world commerce, see
+      `Class.CommerceService:PromptCommerceProductPurchase`. For more
+      information, see
+      [Commerce products](../../../production/monetization/commerce-products.md)
     code_samples: []
     parameters:
       - name: player
@@ -57,9 +73,13 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: CommerceService:GetCommerceProductInfoAsync
-    summary: 'Retrieves information about the commerce products you are selling in experience.'
+    summary: |
+      Retrieves information about the commerce products you are selling in
+      experience.
     description: |
-      Retrieves information about the products that you are selling and surface them within your experience. How you surface products to your users is entirely up to you.
+      Retrieves information about the products that you are selling and surface
+      them within your experience. How you surface products to your users is
+      entirely up to you.
 
       <table><thead>
         <tr>
@@ -90,7 +110,6 @@ methods:
         </tr>
       </tbody>
       </table>
-
     code_samples: []
     parameters:
       - name: commerceProductId
@@ -109,7 +128,12 @@ methods:
     writeCapabilities: []
   - name: CommerceService:UserEligibleForRealWorldCommerceAsync
     summary: ''
-    description: 'This is a legacy endpoint that is not meant for use. To check if a user is eligible for real world commerce, see `Class.PolicyService.IsEligibleToPurchaseCommerceProduct`. For more information, see [Commerce products](../../../production/monetization/commerce-products.md)'
+    description: |
+      This is a legacy endpoint that is not meant for use. To check if a user is
+      eligible for real world commerce, see
+      `Class.PolicyService.IsEligibleToPurchaseCommerceProduct`. For more
+      information, see
+      [Commerce products](../../../production/monetization/commerce-products.md)
     code_samples: []
     parameters: []
     returns:
@@ -124,12 +148,18 @@ methods:
     writeCapabilities: []
 events:
   - name: CommerceService.PromptCommerceProductPurchaseFinished
-    summary: 'Fires when commerce purchase webview has closed - not an indicator that a purchase was successful.'
+    summary: |
+      Fires when commerce purchase webview has closed - not an indicator that a
+      purchase was successful.
     description: |
-      Use this signal to detect when a user has completed the purchasing flow and the webview has closed to resume gameplay within the experience. **This signal does not indicate a successful purchase**, so do not grant virtual items solely from this signal.
-
-      While optional, it is recommended to use this signal to reorient your users on Android, as the commerce purchasing flow will have forced them into portrait mode.
+      Use this signal to detect when a user has completed the purchasing flow
+      and the webview has closed to resume gameplay within the experience.
+      **This signal does not indicate a successful purchase**, so do not grant
+      virtual items solely from this signal.
 
+      While optional, it is recommended to use this signal to reorient your
+      users on Android, as the commerce purchasing flow will have forced them
+      into portrait mode.
     code_samples: []
     parameters:
       - name: user