Document string.split's new optional limit parameter

Author: Sainan

docs/Runtime Environment/String.md

@@ -23,37 +23,20 @@ Splits a string by a separator.
 #### Parameters
 1. The string to split.
 2. The separator to split a string by. This can be any string.
+3. An optional limit for the returned table size.
 #### Returns
 A table.
-```pluto title="Splitting a string by a single character."
+```pluto title="Splitting a string by a single character"
 local s = "hello world, how is everyone doing?"
-local r = string.split(s, " ")
---[[
-    The value of 'r':
-    {
-        "hello",
-        "world,",
-        "how",
-        "is",
-        "everyone",
-        "doing?"
-    }
---]]
+string.split(s, " ") -- { "hello", "world,", "how", "is", "everyone", "doing?" }
 ```
-```pluto title="Splitting a string by a substring."
-local s = "helloHALLOWORLDworld,HALLOWORLDhowHALLOWORLDisHALLOWORLDeveryoneHALLOWORLDdoing?"
-local r = string.split(s, "HALLOWORLD")
---[[
-    The value of 'r':
-    {
-        "hello",
-        "world,",
-        "how",
-        "is",
-        "everyone",
-        "doing?"
-    }
---]]
+```pluto title="Splitting a string by a substring"
+local s = "helloFOOworld,FOOhowFOOisFOOeveryoneFOOdoing?"
+string.split(s, "FOO") -- { "hello", "world,", "how", "is", "everyone", "doing?" }
+```
+```pluto title="Splitting a string by a single character with a limit"
+local s = "hello world, how is everyone doing?"
+string.split(s, " ", 3) -- { "hello", "world,", "how is everyone doing?" }
 ```
 ---
 ### `string.rfind`