Reword accessible prop in accessiblity guide (facebook#4656)

Author: joevilches

docs/accessibility.md

@@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible.
+When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead.
 
-On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`.
+By default, all touchable elements are accessible.
+
+On Android, `accessible` will be translated into native [`focusable`](<https://developer.android.com/reference/android/view/View#setFocusable(boolean)>). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc).
 
 ```tsx
-<View accessible={true}>
-  <Text>text one</Text>
-  <Text>text two</Text>
+<View>
+  <View accessible={true} />
+  <View />
 </View>
 ```
 
-In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'.
+In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`.
 
 ### `accessibilityLabel`
 

docs/view.md

@@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible.
+When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible.
+
+See the [Accessibility guide](accessibility.md#accessible) for more information.
 
 ---
 

website/versioned_docs/version-0.78/accessibility.md

@@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible.
+When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead.
 
-On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`.
+By default, all touchable elements are accessible.
+
+On Android, `accessible` will be translated into native [`focusable`](<https://developer.android.com/reference/android/view/View#setFocusable(boolean)>). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc).
 
 ```tsx
-<View accessible={true}>
-  <Text>text one</Text>
-  <Text>text two</Text>
+<View>
+  <View accessible={true} />
+  <View />
 </View>
 ```
 
-In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'.
+In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`.
 
 ### `accessibilityLabel`
 

website/versioned_docs/version-0.78/view.md

@@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible.
+When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible.
+
+See the [Accessibility guide](accessibility.md#accessible) for more information.
 
 ---
 

website/versioned_docs/version-0.79/accessibility.md

@@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible.
+When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead.
 
-On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`.
+By default, all touchable elements are accessible.
+
+On Android, `accessible` will be translated into native [`focusable`](<https://developer.android.com/reference/android/view/View#setFocusable(boolean)>). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc).
 
 ```tsx
-<View accessible={true}>
-  <Text>text one</Text>
-  <Text>text two</Text>
+<View>
+  <View accessible={true} />
+  <View />
 </View>
 ```
 
-In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'.
+In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`.
 
 ### `accessibilityLabel`
 

website/versioned_docs/version-0.79/view.md

@@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible.
+When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible.
+
+See the [Accessibility guide](accessibility.md#accessible) for more information.
 
 ---
 

website/versioned_docs/version-0.80/accessibility.md

@@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible.
+When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead.
 
-On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`.
+By default, all touchable elements are accessible.
+
+On Android, `accessible` will be translated into native [`focusable`](<https://developer.android.com/reference/android/view/View#setFocusable(boolean)>). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc).
 
 ```tsx
-<View accessible={true}>
-  <Text>text one</Text>
-  <Text>text two</Text>
+<View>
+  <View accessible={true} />
+  <View />
 </View>
 ```
 
-In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'.
+In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`.
 
 ### `accessibilityLabel`
 

website/versioned_docs/version-0.80/view.md

@@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for
 
 ### `accessible`
 
-When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible.
+When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible.
+
+See the [Accessibility guide](accessibility.md#accessible) for more information.
 
 ---