AudioRecorder and Issue Request (#1104)

## Changes

In-reality I wanted to ask question. To find a valid way to do it, I've
updated ``AudioRecorder``, so that now I can use this text field here,
and type my question. **Because issue requests are disabled.**


Info is from
<https://create.roblox.com/docs/en-us/release-notes/release-notes-671>
and <https://devforum.roblox.com/t/release-notes-for-671> and own
testing in the current public version through Fast Flags.

* <https://devforum.roblox.com/t/release-notes-for-671/3634028/50>
* <https://devforum.roblox.com/t/release-notes-for-671/3634028/61>

## Checks

By submitting your pull request for review, you agree to the following:

- [x] This contribution was created in whole or in part by me, and I
have the right to submit it under the terms of this repository's open
source licenses.
- [x] I understand and agree that this contribution and a record of it
are public, maintained indefinitely, and may be redistributed under the
terms of this repository's open source licenses.
- [x] To the best of my knowledge, all proposed changes are accurate.


&nbsp;

# Issue

Alright. Now, to the issue.

In
https://create.roblox.com/docs/en-us/reference/engine/classes/ProximityPrompt
for instance, you can find a text that says

> The example below generates a custom

which is in a Code Sample, and that's currently not a thing

But what I am trying to say is, that there are pages, that aren't in
this Repository. And they can not be edited :(
There were moments where I wanted to edit something. I've probably
forgotten. But where do I go then? 🤔 Do I actually just go on the
Developer Forums with a Bug Report for everything?

Please fix.

---------

Co-authored-by: IgnisRBX <[email protected]>
Co-authored-by: rbxphogen <[email protected]>

Author: 3 people

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

@@ -1,8 +1,15 @@
 name: AudioRecorder
 type: class
 memory_category: Internal
-summary: ''
-description: ''
+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.
+
+  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.
 code_samples: []
 inherits:
   - Instance
@@ -12,7 +19,8 @@ deprecation_message: ''
 properties:
   - name: AudioRecorder.IsRecording
     summary: ''
-    description: ''
+    description: |
+      Returns whether the `AudioRecorder` is currently recording.
     code_samples: []
     type: boolean
     tags: []
@@ -30,7 +38,8 @@ properties:
     writeCapabilities: []
   - name: AudioRecorder.TimeLength
     summary: ''
-    description: ''
+    description: |
+      Returns the current length of the recording in seconds.
     code_samples: []
     type: double
     tags:
@@ -51,7 +60,8 @@ properties:
 methods:
   - name: AudioRecorder:Clear
     summary: ''
-    description: ''
+    description: |
+      Clears out the recording from the `AudioRecorder`.
     code_samples: []
     parameters: []
     returns:
@@ -115,7 +125,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:GetTemporaryContent
     summary: ''
-    description: ''
+    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.
     code_samples: []
     parameters: []
     returns:
@@ -130,7 +142,8 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:Stop
     summary: ''
-    description: ''
+    description: |
+      Stops recording.
     code_samples: []
     parameters: []
     returns:
@@ -145,7 +158,10 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:CanRecordAsync
     summary: ''
-    description: ''
+    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
+      `Class.AudioRecorder:Clear()|Clear()`.
     code_samples: []
     parameters: []
     returns:
@@ -161,7 +177,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:GetUnrecordableInstancesAsync
     summary: ''
-    description: ''
+    description: |
+      Traverses the audio graph, starting from this recorder's inputs, to find unrecordable instances.
+      Currently, `Class.AudioDeviceInput` is not recordable.
     code_samples: []
     parameters: []
     returns:
@@ -177,7 +195,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:RecordAsync
     summary: ''
-    description: ''
+    description: |
+      If `Class.AudioRecorder:CanRecordAsync()|CanRecordAsync()` returns `true`, recording begins.
+      If recording cannot begin, this method produces an error.
     code_samples: []
     parameters: []
     returns: