Update custom renderer docs

gaearon · web-flow · commit 394b17eede14 · 2018-06-09T22:19:12.000+01:00
diff --git a/packages/react-reconciler/README.md b/packages/react-reconciler/README.md
@@ -11,12 +11,12 @@ This is an experimental package for creating custom React renderers.
 ```js
 var Reconciler = require('react-reconciler');
 
-var ReconcilerConfig = {
+var HostConfig = {
   // You'll need to implement some methods here.
   // See below for more information and examples.
 };
 
-var MyRenderer = Reconciler(ReconcilerConfig);
+var MyRenderer = Reconciler(HostConfig);
 
 var RendererPublicAPI = {
   render(element, container, callback) {
@@ -30,10 +30,30 @@ module.exports = RendererPublicAPI;
 
 ## Practical Examples
 
-* [React ART](https://github.com/facebook/react/blob/master/packages/react-art/src/ReactART.js)
-* [React DOM](https://github.com/facebook/react/blob/master/packages/react-dom/src/client/ReactDOM.js)
-* [React Native](https://github.com/facebook/react/blob/master/packages/react-native-renderer/src/ReactNativeRenderer.js)
+A "host config" is an object that you need to provide, and that describes how to make something happen in the "host" environment (e.g. DOM, canvas, console, or whatever your rendering target is). It looks like this:
 
-If these links break please file an issue and we’ll fix them. They intentionally link to the latest versions since the API is still evolving.
+```js
+var HostConfig = {
+  createInstance(type, props) {
+    // e.g. DOM renderer returns a DOM node
+  },
+  // ...
+  supportsMutation: true, // it works by mutating nodes
+  appendChild(parent, child) {
+    // e.g. DOM renderer would call .appendChild() here
+  },
+  // ...
+};
+```
+
+The full list of supported methods [can be found here](https://github.com/facebook/react/blob/master/packages/react-reconciler/src/forks/ReactFiberHostConfig.custom.js). For their signatures, we recommend looking at specific examples below.
+
+The React repository includes several renderers. Each of them has its own host config.
+
+The examples in the React repository are declared a bit differently than a third-party renderer would be. In particular, the `HostConfig` object mentioned above is never explicitly declared, and instead is a *module* in our code. However, its exports correspond directly to properties on a `HostConfig` object you'd need to declare in your code:
+
+* [React ART](https://github.com/facebook/react/blob/master/packages/react-art/src/ReactART.js) and its [host config](https://github.com/facebook/react/blob/master/packages/react-art/src/ReactARTHostConfig.js)
+* [React DOM](https://github.com/facebook/react/blob/master/packages/react-dom/src/client/ReactDOM.js) and its [host config](https://github.com/facebook/react/blob/master/packages/react-dom/src/client/ReactDOMHostConfig.js)
+* [React Native](https://github.com/facebook/react/blob/master/packages/react-native-renderer/src/ReactNativeRenderer.js) and its [host config](https://github.com/facebook/react/blob/master/packages/react-native-renderer/src/ReactNativeHostConfig.js)
 
-This [third-party tutorial](https://github.com/nitin42/Making-a-custom-React-renderer) is relatively up-to-date and may be helpful.
+If these links break please file an issue and we’ll fix them. They intentionally link to the latest versions since the API is still evolving. If you have more questions please file an issue and we’ll try to help!
