react-native-website-migration · slorber · Oct 9, 2020 · Aug 30, 2020 · Aug 30, 2020 · Aug 30, 2020
diff --git a/README.md b/README.md
@@ -80,7 +80,7 @@ As mentioned above, the `docs` folder contains the source files for all of the d
 
 ### Versioned docs
 
-The React Native website is versioned as to allow users to go back and see the API reference docs for any given release. A new version of the website is generally generated whenever there is a new React Native release. When this happens, any changes made to the `docs` and `website/sidebars.json` files will be copied over to the corresponding location within `website/versioned_docs` and `website/versioned_sidebars`.
+The React Native website is versioned to allow users to go back and see the API reference docs for any given release. A new version of the website is generally generated whenever there is a new React Native release. When this happens, any changes made to the `docs` and `website/sidebars.json` files will be copied over to the corresponding location within `website/versioned_docs` and `website/versioned_sidebars`.
 
 > **_Note:_** Do not edit the auto-generated files within `versioned_docs` or `versioned_sidebars` unless you are sure it is necessary. Edits made to older versions will not be propagated to newer versions of the docs.
 
@@ -116,7 +116,7 @@ The `showcase.json` file contains the list of users that are highlighted in the
 1.  Follow the "[Running locally](#running-locally)" instructions.
 1.  Save the files and check in the browser.
 1.  Some changes may require a server restart to generate new files. (Pages in `docs` always do!)
-1.  Edits to pages in `docs` will only be visible in the latest version of the documentation, called "Next", located under `docs/next` path.
+1.  Edits to pages in `docs` will only be visible in the latest version of the documentation, called "Next", located under the `docs/next` path.
 
 Visit **http://localhost:3000/docs/next/YOUR-DOCS-PAGE** to see your work.
 
@@ -126,7 +126,7 @@ Visit **http://localhost:3000/docs/next/YOUR-DOCS-PAGE** to see your work.
 
 If possible, test any visual changes in all latest versions of the following browsers:
 
-- Chrome and Firefox on desktop.
+- Chrome and Firefox on the desktop.
 - Chrome and Safari on mobile.
 
 ### Push it

diff --git a/docs/actionsheetios.md b/docs/actionsheetios.md
@@ -73,6 +73,7 @@ Display an iOS action sheet. The `options` object must contain one or more of:
 - `message` (string) - a message to show below the title
 - `anchor` (number) - the node to which the action sheet should be anchored (used for iPad)
 - `tintColor` (string) - the [color](colors) used for non-destructive button titles
+- `disabledButtonIndices` (array of numbers) - a list of button indices which should be disabled
 
 The 'callback' function takes one parameter, the zero-based index of the selected item.
 

diff --git a/docs/alert.md b/docs/alert.md
@@ -7,9 +7,9 @@ Launches an alert dialog with the specified title and message.
 
 Optionally provide a list of buttons. Tapping any button will fire the respective onPress callback and dismiss the alert. By default, the only button will be an 'OK' button.
 
-This is an API that works both on Android and iOS and can show static alerts. To show an alert that prompts the user to enter some information, see `AlertIOS`; entering text in an alert is common on iOS only.
+This is an API that works both on Android and iOS and can show static alerts. Alert that prompts the user to enter some information is avaiable on iOS only.
 
-### Example
+## Example
 
 <div class="toggler">
   <ul role="tablist" class="toggle-syntax">
@@ -149,7 +149,7 @@ export default App;
 
 ## iOS
 
-On iOS you can specify any number of buttons. Each button can optionally specify a style, which is one of 'default', 'cancel', or 'destructive'.
+On iOS you can specify any number of buttons. Each button can optionally specify a style, avaiable options are represented by the [AlertButtonStyle](#alertbuttonstyle) enum.
 
 ## Android
 
@@ -159,33 +159,41 @@ On Android at most three buttons can be specified. Android has a concept of a ne
 - Two buttons mean 'negative', 'positive' (such as 'Cancel', 'OK')
 - Three buttons mean 'neutral', 'negative', 'positive' (such as 'Later', 'Cancel', 'OK')
 
-Alerts on Android can be dismissed by tapping outside of the alert box. It is disabled by default and can be enabled by providing an optional `options` parameter with the cancelable property set to true i.e. `{ cancelable: true }`.
+Alerts on Android can be dismissed by tapping outside of the alert box. It is disabled by default and can be enabled by providing an optional [Options](alert#options) parameter with the cancelable property set to `true` i.e.<br/>`{ cancelable: true }`.
 
-The cancel event can be handled by providing an `onDismiss` callback property `{ onDismiss: () => {} }` inside the `options` parameter.
+The cancel event can be handled by providing an `onDismiss` callback property inside the `options` parameter.
 
-Example usage:
+### Example <div class="label android">Android</div>
 
-```jsx
-Alert.alert('Alert Title', 'My Alert Msg', [
-  {
-    text: 'Ask me later',
-    onPress: () => console.log('Ask me later pressed')
-  },
-  {
-    text: 'Cancel',
-    onPress: () => console.log('Cancel Pressed'),
-    style: 'cancel'
-  },
-  { text: 'OK', onPress: () => console.log('OK Pressed') },
-  {
-    // cancelable and onDismiss only work on Android.
-    cancelable: true,
-    onDismiss: () =>
-      console.log(
-        'This alert was dismissed by tapping outside of the alert dialog.'
-      )
-  }
-]);
+```SnackPlayer name=Alert%20Android%20Dissmissable%20Example&supportedPlatforms=android
+import React from "react";
+import { View, StyleSheet, Button, Alert } from "react-native";
+
+const showAlert = () =>
+  Alert.alert(
+    "Alert Title",
+    "My Alert Msg",
+    [
+      {
+        text: "Cancel",
+        onPress: () => Alert.alert("Cancel Pressed"),
+        style: "cancel",
+      },
+    ],
+    {
+      cancelable: true,
+      onDismiss: () =>
+        Alert.alert(
+          "This alert was dismissed by tapping outside of the alert dialog."
+        ),
+    }
+  );
+
+const App = () => (
+  <Button title="Show alert" onPress={showAlert} />
+);
+
+export default App;
 ```
 
 ---
@@ -199,3 +207,105 @@ Alert.alert('Alert Title', 'My Alert Msg', [
 ```jsx
 static alert(title, message?, buttons?, options?)
 ```
+
+**Parameters:**
+
+| Name    | Type                                                              | Description                                                             |
+| ------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| title   | string <div class="label basic required">Required</div>           | The dialog's title. Passing `null` or empty string will hide the title. |
+| message | string                                                            | An optional message that appears below the dialog's title.              |
+| buttons | [Buttons](alert#buttons)                                          | An optional array containg buttons configuration.                       |
+| options | [Options](alert#options) <div class="label android">Android</div> | An optional Alert configuration for the Android.                        |
+
+---
+
+### `prompt()` <div class="label ios">iOS</div>
+
+```jsx
+static prompt(title, message?, callbackOrButtons?, type?, defaultValue?, keyboardType?)
+```
+
+Create and display a prompt to enter some text in form of Alert.
+
+**Parameters:**
+
+| Name              | Type                                                    | Description                                                                                                                                                                                           |
+| ----------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| title             | string <div class="label basic required">Required</div> | The dialog's title.                                                                                                                                                                                   |
+| message           | string                                                  | An optional message that appears above the text input.                                                                                                                                                |
+| callbackOrButtons | function<hr/>[Buttons](alert#buttons)                   | If passed a function, it will be called with the prompt's value<br/>`(text: string) => void`, when the user taps 'OK'.<hr/>If passed an array, buttons will be configured based on the array content. |
+| type              | [AlertType](alert#alerttype)                            | This configures the text input.                                                                                                                                                                       |
+| defaultValue      | string                                                  | The default text in text input.                                                                                                                                                                       |
+| keyboardType      | string                                                  | The keyboard type of first text field (if exists). One of TextInput [keyboardTypes](textinput#keyboardtype).                                                                                          |
+
+---
+
+## Type Definitions
+
+### AlertButtonStyle <div class="label ios">iOS</div>
+
+An iOS Alert button style.
+
+| Type |
+| ---- |
+| enum |
+
+**Constants:**
+
+| Value           | Description               |
+| --------------- | ------------------------- |
+| `'default'`     | Default button style.     |
+| `'cancel'`      | Cancel button style.      |
+| `'destructive'` | Destructive button style. |
+
+---
+
+### AlertType <div class="label ios">iOS</div>
+
+An iOS Alert type.
+
+| Type |
+| ---- |
+| enum |
+
+**Constants:**
+
+| Value              | Description                  |
+| ------------------ | ---------------------------- |
+| `'default'`        | Default alert with no inputs |
+| `'plain-text'`     | Plain text input alert       |
+| `'secure-text'`    | Secure text input alert      |
+| `'login-password'` | Login and password alert     |
+
+---
+
+### Buttons
+
+Array of objects containg Alert buttons configuration.
+
+| Type             |
+| ---------------- |
+| array of objects |
+
+**Objects properties:**
+
+| Name                                   | Type                                       | Description                                             |
+| -------------------------------------- | ------------------------------------------ | ------------------------------------------------------- |
+| text                                   | string                                     | Button label.                                           |
+| onPress                                | function                                   | Callback function when button is pressed.               |
+| style <div class="label ios">iOS</div> | [AlertButtonStyle](alert#alertbuttonstyle) | Button style, on Android this property will be ignored. |
+
+---
+
+### Options <div class="label android">Android</div>
+
+| Type   |
+| ------ |
+| object |
+
+**Properties:**
+
+| Name       | Type     | Description                                                            |
+| ---------- | -------- | ---------------------------------------------------------------------- |
+| cancelable | boolean  | Defines if alert can be dismissed by tapping outside of the alert box. |
+| onDismiss  | function | Callback function fired when alert has been dismissed.                 |
diff --git a/docs/appregistry.md b/docs/appregistry.md
@@ -44,7 +44,7 @@ Only called from native code. Cancels a headless task.
 
 **Parameters:**
 
-| Name                                                     | Type   | Required                                                                                |
+| Name                                                     | Type   | Description                                                                                |
 | -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------- |
 | taskId <div class="label basic required">Required</div>  | number | The native id for this task instance that was used when `startHeadlessTask` was called. |
 | taskKey <div class="label basic required">Required</div> | string | The key for the task that was used when `startHeadlessTask` was called.                 |

diff --git a/docs/building-for-tv.md b/docs/building-for-tv.md
@@ -155,4 +155,8 @@ class Game2048 extends React.Component {
 
 - _Known issues_:
 
-  - `TextInput` components do not work for now (i.e. they cannot receive focus, see [this comment](https://github.com/facebook/react-native/pull/16500#issuecomment-629285638)).
+  - `TextInput` components do not work for now (i.e. they cannot receive focus automatically, see [this comment](https://github.com/facebook/react-native/pull/16500#issuecomment-629285638)). 
+    - It is however possible to use a ref to manually trigger `inputRef.current.focus()`. 
+    - You can wrap your input inside a `TouchableWithoutFeedback` component and trigger focus in the `onFocus` event of that touchable. This enables opening the keyboard via the arrow keys.
+    - The keyboard might reset its state after each keypress (this might only happen inside the Android TV emulator).
+  - The content of `Modal` components cannot receive focus, see [this issue](https://github.com/facebook/react-native/issues/24448) for details.
diff --git a/docs/debugging.md b/docs/debugging.md
@@ -45,7 +45,7 @@ LogBox.ignoreAllLogs();
 
 ### Unhandled Errors
 
-Unhanded JavaScript errors such as `undefined is not a function` will automatically open a full screen LogBox error with the source of the error. These errors are dismissable and minimizable so that you can see the state of your app when these errors occur, but should always be addressed.
+Unhandled JavaScript errors such as `undefined is not a function` will automatically open a full screen LogBox error with the source of the error. These errors are dismissable and minimizable so that you can see the state of your app when these errors occur, but should always be addressed.
 
 ### Syntax Errors