address CR

Author: mfori

sources/platform/actors/development/actor_definition/input_schema/specification.md

@@ -162,7 +162,7 @@ String is the most common input field type, and provide a number of editors and
 | `maxLength`           | Integer                                                                                                                                          | No                               | Maximum length of the string.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `enum`                | [String]                                                                                                                                         | Required if `editor` is `select` | Using this field, you can limit values to the given array of strings. Input will be displayed as select box. Values are strictly validated against this list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `enumSuggestedValues` | [String]                                                                                                                                         | No                               | Similar to `enum`, but only suggests values in the UI without enforcing validation. Users can select from the dropdown or enter custom value.<br/> Works only with the `select` editor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| `enumTitles`          | [String]                                                                                                                                         | No                               | Titles for the `enum` or `enumSuggestedValues` keys described.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `enumTitles`          | [String]                                                                                                                                         | No                               | Displayed titles for the `enum` or `enumSuggestedValues` properties.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `nullable`            | Boolean                                                                                                                                          | No                               | Specifies whether `null` is an allowed value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `isSecret`            | Boolean                                                                                                                                          | No                               | Specifies whether the input field will be stored encrypted. Only available with `textfield`, `textarea` and `hidden` editors.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `dateType`            | One of <ul><li>`absolute`</li><li>`relative`</li><li>`absoluteOrRelative`</li></ul>                                                              | No                               | This property, which is only available with `datepicker` editor, specifies what date format should visual editor accept (The JSON editor accepts any string without validation.).<br/><br/><ul><li>`absolute` value enables date input in `YYYY-MM-DD` format. To parse returned string regex like this can be used: `^(\d{4})-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$`.</li><br/><li>`relative` value enables relative date input in <br/>`{number} {unit}` format. <br/>Supported units are: days, weeks, months, years.<br/><br/>The input is passed to the Actor as plain text (e.g., "3 weeks"). To parse it, regex like this can be used: `^(\d+)\s*(day\|week\|month\|year)s?$`.</li><br/><li>`absoluteOrRelative` value enables both absolute and relative formats and user can switch between them. It's up to Actor author to parse a determine actual used format - regexes above can be used to check whether the returned string match one of them.</li></ul><br/>Defaults to `absolute`. |
@@ -173,9 +173,10 @@ When using escape characters `\` for the regular expression in the `pattern` fie
 
 :::
 
-#### Select
+#### Select editor for strings
 
-Enables you to provide a list of predefined values for the string, including display titles.
+The `select` editor for strings allows users to choose a value from a dropdown list.
+You can either only allow users to select from a set of predefined values, or allow them to specify custom values in addition to suggested values.
 
 ##### Select from predefined values
 
@@ -213,7 +214,7 @@ When you want to suggest values but still allow custom input, use the `enumSugge
 }
 ```
 
-This creates a select dropdown with suggested values, but users can also enter custom value:
+This creates a select dropdown with suggested values, but users can also enter custom values:
 
 ![Apify Actor input schema - tag input suggestion](./images/input-schema-tag-suggestion.png)
 
@@ -667,7 +668,7 @@ Editor type `globs` maps to the Crawlee's [GlobInput](https://crawlee.dev/api/co
 
 Editor type `fileupload` enables users to specify a list of files as input. The input is passed to the Actor as an array of strings. The Actor author is responsible for interpreting the strings, including validating file existence and format. This editor simplifies the process for users to upload files to a key-value store of their choice.
 
-#### Select editor for arrays (multiselect)
+#### Select editor for arrays
 
 The `select` editor for arrays allows users to pick multiple items from a dropdown list. This creates a multiselect field in the UI.
 You can either only allow users to select from a set of predefined values, or allow them to specify custom values in addition to suggested values.