add code of conduct and flesh out readme

Author: timelyportfolio

.Rbuildignore

@@ -1,2 +1,3 @@
 ^roffice\.Rproj$
 ^\.Rproj\.user$
+^CODE_OF_CONDUCT\.md$

CODE_OF_CONDUCT.md

@@ -0,0 +1,25 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who 
+contribute through reporting issues, posting feature requests, updating documentation,
+submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for
+everyone, regardless of level of experience, gender, gender identity and expression,
+sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or
+imagery, derogatory comments or personal attacks, trolling, public or private harassment,
+insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments,
+commits, code, wiki edits, issues, and other contributions that are not aligned to this 
+Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed 
+from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by 
+opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the Contributor Covenant 
+(http://contributor-covenant.org), version 1.0.0, available at 
+http://contributor-covenant.org/version/1/0/0/

README.md

@@ -4,7 +4,16 @@
 
 > Alan Dilpert session at [rstudio::conf](http://www.cvent.com/events/rstudio-conf-austin/agenda-dd6d75526f3c4554b67c4de32aeffb47.aspx)
 
-In `roffice` we illustrate some alternate techniques
+In `roffice` we illustrate some alternate techniques for building an `htmlwidget` around the extensive set of components from the Microsoft [Fabric](https://developer.microsoft.com/en-us/fabric) project.  Instead of using a `yarn` build with JavaScript modules, we use the `umd` build of Fabric.  Many React libraries do not offer a standalone build.  If the component or component set does provide a standalone build, then we can avoid the potentially difficult JavaScript/npm/yarn steps, and directly use only a couple of lines of JavaScript (see [officeuiwidget](https://github.com/timelyportfolio/roffice/blob/master/inst/htmlwidgets/officeuiwidget.js)).
+
+```
+// trick to include React Fragment component
+//  which is like an empty container
+Fabric.Fragment = React.Fragment;
+
+// office-ui-fabric namespaces all the components with Fabric
+reactR.reactWidget('officeuiwidget', 'output', Fabric);
+```
 
 ## Installation
 
@@ -15,11 +24,15 @@ devtools::install_github("timelyportfolio/reactR@enhancements")
 devtools::install_github("timelyportfolio/roffice")
 ```
 
-## Example
+## Examples
 
-This is a basic example which shows you how to solve a common problem:
+There are multiple examples [here](https://github.com/timelyportfolio/roffice/tree/master/inst/examples), but for the sake of including some code in this Readme.
 
 ``` r
-## basic example code
+library(reactR)
+library(roffice)
 ```
 
+## Code of Conduct
+
+We would love help, comments, feedback, and other contributions, but please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md).  By participating in this project you agree to abide by its terms.  Violations, meanness, and any other behavior that is not inclusive and welcoming will not be tolerated.