Merge branch 'main' into fix-presimulation-dtsim-description

Author: IgnisRBX

content/en-us/luau/strings.md

@@ -460,12 +460,25 @@ local key3, val3 = string.match("OneMillion=1000000", pattern)
 print(key3, val3)  --> OneMillion 1000000
 ```
 
-In the previous pattern, the `?` quantifier that follows both of the `%s`
-classes is a safe addition because it makes the space on either side of the
-`=` sign optional. That means the match succeeds if one (or both) spaces are
-missing around the equal sign.
+The `?` quantifier that follows both of the `%s` classes is a safe addition
+because it makes the space on either side of the `=` sign optional. That means
+the match succeeds if one (or both) spaces are missing around the equal sign.
 
-String captures can also be **nested** as the following example:
+In the `Library.string.gsub()` function, you can include capture groups in the
+replacement string using `%1`, `%2`, `%3`, etc., up to `%9`. Even though Luau
+supports up to 32 capture groups before throwing an error, you can only
+reference the first nine with this syntax:
+
+```lua
+local str = "love2play Roblox"
+local pattern = "(%w+)(%d+)(%w+)%s+(%w+)"
+local replacement = "I %1 %2 %3 %4!"
+
+local result = string.gsub(str, pattern, replacement)
+print(result) --> I love 2 play Roblox!
+```
+
+You can also nest string captures:
 
 ```lua
 local places = "The Cloud Kingdom is heavenly, The Forest Kingdom is peaceful"

content/en-us/reference/engine/libraries/string.yaml

@@ -8,9 +8,9 @@ description: |
   the global `Library.string` library.
 
   See
-  [String Pattern Reference](../../../luau/strings.md#string-pattern-reference)
-  for details on using `Library.string.match()` and `Library.string.gmatch()` to
-  find a piece, or substring, of a longer string.
+  [String pattern reference](../../../luau/strings.md#string-pattern-reference)
+  for details on using `Library.string.match()`, `Library.string.gmatch()`, and
+  `Library.string.gsub()` to find (and replace) substrings.
 code_samples:
 properties:
 functions:
@@ -421,16 +421,18 @@ functions:
       #### Various Examples
 
       ```lua
-      -- Simple replacement
+      -- Basic replacement
       string.gsub("I love tacos!", "tacos", "Roblox") --> I love Roblox! 1
-      -- Using a pattern (hint: %w+ matches whole words)
-      string.gsub("I like red!", "%w+", "word") --> word word word 3
+      -- Replacement with a pattern
+      string.gsub("I like red!", "%w+", "word") --> word word word! 3
       -- Replacement table
       string.gsub("I play Roblox.", "%w+", {I="Je", play="joue à"}) --> Je joue à Roblox. 3
       -- Replacement function
       string.gsub("I have 2 cats.", "%d+", function(n) return tonumber(n) * 12 end) --> I have 24 cats. 1
       -- Replace only twice
-      string.gsub("aaa", "a", "b", 2) --> "bba", 2
+      string.gsub("aaa", "a", "b", 2) --> bba 2
+      -- Replacement with capture groups (maximum of nine)
+      string.gsub("love2play Roblox", "(%w+)(%d+)(%w+)%s+(%w+)", "I %1 %2 %3 %4!") --> I love 2 play Roblox! 1
       ```
     parameters:
       - name: s

tools/checks/utils/do-not-machine-translate.txt

@@ -14,5 +14,5 @@ content/en-us/get-started.md
 content/en-us/monetize.md
 content/en-us/platform.md
 content/en-us/scale.md
-content/en-us/studio.md
+content/en-us/studio/index.md
 content/en-us/education/resources/roblox-educators.md