add some discussion on new htmlwidget functionality in README

Author: timelyportfolio

README.md

@@ -1,28 +1,33 @@
 [![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/reactR)](https://cran.r-project.org/package=reactR)
 [![Travis-CI Build Status](https://travis-ci.org/react-R/reactR.svg?branch=master)](https://travis-ci.org/react-R/reactR)
 
-<img height="150px" alt="react-R logo" src="assets/logos/reactR-logo.png"/>
+<img height="150px" alt="react-R logo" src="https://github.com/react-R/reactR/raw/enhancements/assets/logos/reactR-logo.png"/>
 
 # reactR
 
-A set of convenience function with local dependencies for using [`React`](https://facebook.github.io/react) in `R`.  This is modeled after the `html_dependency_*` functions from RStudio's [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.
+`reactR` provides a set of convenience functions for using [`React`](https://facebook.github.io/react) in `R` with `htmlwidget` constructor templates and local JavaScript dependencies.  The `React` ecosystem is rich with comoponents that can enhance `R` web and shiny apps.  `scaffoldWidget` helps build `htmlwidgets` to integrate these `React` components as `R` `htmlwidgets`.  The local dependency functions are modeled after the `html_dependency_*` functions from RStudio's [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.
 
 ## Installation
 
-You can install reactR from github with:
+You can install reactR from CRAN with `install.packages("reactR")`.  For the development version, please use `devtools` as shown below.
 
 ```R
 # install.packages("devtools")
 devtools::install_github("react-R/reactR")
 ```
 
-## Example
+## Creating htmlwidgets with React Components
+
+To wrap a `React` component as an `htmlwidget`, please see the tutorial [htmlwidgets with reactR](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html).  Also, there are a variety of examples in the [react-R Github organization](https://github.com/react-R).
+
+## Examples
 
 ```R
 library(reactR)
 library(htmltools)
 
 browsable(tagList(
+  tags$div(id = "app"),
   tags$script(
   "
     ReactDOM.render(
@@ -31,7 +36,7 @@ browsable(tagList(
         null,
         'Powered by React'
       ),
-      document.body
+      document.getElementById('app')
     )
   "
   ),
@@ -41,16 +46,17 @@ browsable(tagList(
 ))
 ```
 
-`reactR` also uses `V8` if available to transform `JSX` and `ES2015` code.
+`reactR` also uses the `V8` package if available to transform `JSX` and `ES2015` code.
 
 ```R
 library(reactR)
 library(htmltools)
 
 browsable(
   tagList(
+    tags$div(id = "app"),
     tags$script(
-      babel_transform('ReactDOM.render(<h1>Powered By React/JSX</h1>,document.body)')
+      babel_transform('ReactDOM.render(<h1>Powered By React/JSX</h1>,document.getElementById("app"))')
     ),
     # add core-js shim first for React in RStudio Viewer
     html_dependency_corejs(),
@@ -61,4 +67,4 @@ browsable(
 
 ## Contributing and Code of Conduct
 
-I welcome contributors.  Help make this package great.  Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.
+We welcome contributors and would love your participation.  Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by the terms.