Proposal 0001 - Extract WebView From Core

Author: jamonholmgren

proposals/0001-template.md

@@ -0,0 +1,60 @@
+---
+title: Extract WebView From Core
+author:
+- Jamon Holmgren
+date: 2018-07-30
+---
+
+# RFC0000: Extract WebView From Core
+
+## Summary
+
+Extract the current WebView implementation from React Native Core and move it into a third party package.
+
+## Basic example
+
+Currently, WebView is included in React Native core:
+
+```jsx
+import { WebView } from 'react-native';
+```
+
+This would move it to an external package, like so:
+
+```jsx
+import { WebView } from '@infinitered/react-native-webview';
+```
+
+## Motivation
+
+The current WebView implementation is (to my knowledge) not used by Facebook internally. This leads (understandably) to a lack of first-class support for this core API. By moving the component to a third party that is more invested in supporting it, there will be better support.
+
+Additionally, with this component no longer included in core, there will be an opening for alternative third party WebView implementations, should anyone else wish to provide one.
+
+## Detailed design
+
+For the first release, the goal is to provide the same API, only replacing the import statement and otherwise backwards compatible.
+
+We will also want to update generated project boilerplates, such as create-react-native-app and Ignite, to use the new package.
+
+## Drawbacks
+
+This is a breaking change in that if someone simply updates their React Native version in an app that uses WebView and this core API is gone, their app will break.
+
+It also means there won't be an officially supported WebView in React Native, which may feel to some to be missing key functionality.
+
+## Alternatives
+
+The primary alternative is to keep the WebView in core. There are also existing third party WebViews, although none that are reliably cross-platform.
+
+## Adoption strategy
+
+This is a breaking change and existing React Native authors who use WebView will need to update their apps to access one of the third party solutions. For most, it should be as simple as `yarn add @infinitered/react-native-webview` and update their import statements.
+
+## How we teach this
+
+We will need to update the React Native documentation to point out that WebView is now moved to a third party module.
+
+## Unresolved questions
+
+None so far.