update Open Source Docs from Roblox internal teams

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

content/en-us/luau/comments.md

@@ -47,6 +47,29 @@ If necessary, you can nest multiple brackets inside a block comment using the sa
 ]=]
 ```
 
+## Comment directives
+
+Luau uses comments that start with `!` to control features like [type checking](type-checking.md), [native code generation](native-code-gen.md), and [linting](https://luau.org/lint).
+
+```lua
+--!strict
+--!nonstrict
+--!nocheck
+--!native
+--!nolint
+--!optimize 0|1|2
+```
+
+For linting, Roblox Studio enables the following subset of warning codes from the [Luau linter](https://luau.org/lint): 1, 2, 3, 6, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28.
+
+The `--!optimize` directive controls the optimization level of the Luau compiler for the script:
+
+- 0 disables optimizations.
+- 1 enables basic optimizations (default in Studio testing).
+- 2 enables further optimizations (default in live games).
+
+Exact optimizations aren't published and are subject to change. We recommend using the default values unless you have a specific reason not to.
+
 ## To-do comments
 
 Roblox Studio supports special `TODO` comments. Studio bolds any text following `TODO` (until broken by a space):

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

@@ -230,7 +230,8 @@ methods:
     deprecation_message: ''
     security: None
     thread_safety: Unsafe
-    capabilities: []
+    capabilities:
+      - Avatar
     writeCapabilities: []
 events: []
 callbacks: []

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

@@ -47,12 +47,12 @@ methods:
     parameters:
       - name: topic
         type: string
-        default:
+        default: ''
         summary: |
           The topic used to identify the type of message.
       - name: function
         type: Function
-        default:
+        default: ''
         summary: ''
     returns:
       - type: RBXScriptConnection
@@ -93,12 +93,12 @@ methods:
     parameters:
       - name: topic
         type: string
-        default:
+        default: ''
         summary: |
           The topic used to identify the type of message.
       - name: function
         type: Function
-        default:
+        default: ''
         summary: ''
     returns:
       - type: RBXScriptConnection
@@ -133,12 +133,12 @@ methods:
     parameters:
       - name: topic
         type: string
-        default:
+        default: ''
         summary: |
           The topic used to identify the message being sent.
       - name: message
         type: Tuple
-        default:
+        default: ''
         summary: |
           The contents of the message to send to the Actor.
     returns:

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

@@ -98,7 +98,7 @@ callbacks:
     parameters:
       - name: eventInfo
         type: Dictionary
-        default:
+        default: ''
         summary: |
           Options table for the method:
 
@@ -113,5 +113,6 @@ callbacks:
     deprecation_message: ''
     security: None
     thread_safety: Unsafe
-    capabilities: []
+    capabilities:
+      - UI
     writeCapabilities: []

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

@@ -26,7 +26,7 @@ methods:
     parameters:
       - name: devProductId
         type: int64
-        default:
+        default: ''
         summary: ''
     returns:
       - type: AdReward
@@ -64,7 +64,7 @@ methods:
     parameters:
       - name: adFormat
         type: AdFormat
-        default:
+        default: ''
         summary: ''
     returns:
       - type: Variant
@@ -83,11 +83,11 @@ methods:
     parameters:
       - name: player
         type: Player
-        default:
+        default: ''
         summary: ''
       - name: reward
         type: AdReward
-        default:
+        default: ''
         summary: ''
     returns:
       - type: ShowAdResult
@@ -109,7 +109,7 @@ events:
     parameters:
       - name: adShown
         type: boolean
-        default:
+        default: ''
         summary: ''
     tags:
       - Deprecated