tweak vignette/docs

Author: cpsievert

README.md

@@ -31,16 +31,17 @@ If you use [ggplot2](http://cran.r-project.org/web/packages/ggplot2/index.html),
 
 ```r
 library(plotly)
+set.seed(100)
 d <- diamonds[sample(nrow(diamonds), 1000), ]
 p <- ggplot(data = d, aes(x = carat, y = price)) + 
   geom_point(aes(text = paste("Clarity:", clarity)), size = 4) +
   geom_smooth(aes(colour = cut, fill = cut)) + facet_wrap(~ cut)
 (gg <- ggplotly(p))
 ```
 
-![https://plot.ly/~brnvg/1132](http://imgur.com/tbKybEb)
+![https://plot.ly/~agvd/1153](http://imgur.com/tbKybEb)
 
-[Click here](https://plot.ly/~brnvg/1132) to interact with the resulting graph (notice the custom hover text!)
+[Click here](https://plot.ly/~agvd/1153) to interact with the resulting graph (notice the custom hover text!)
 
 
 The `ggplotly()` function converts a ggplot object to a plotly object, so if you like, you may 'post-process' your ggplot graphs to add custom plotly features, for example:

vignettes/intro.Rmd

@@ -16,9 +16,9 @@ knitr::opts_chunk$set(eval = FALSE)
 
 Version 1.0.0 of the [plotly R package](https://github.com/ropensci/plotly) introduces a new high-level interface for working with plotly's JavaScript graphing library from R. The aim of this vignette is to explain the semantics of this interface, but I also recommend perusing [plotly's R homepage](https://plot.ly/r/) for more examples.
 
-## Creating and modifying plotlys
+## Creating plotlys
 
-To initiate a plotly object, use `plot_ly()`. Here we turn the `economics` data frame (from the ggplot2 package) into a plotly visualization and store it as the object `p`.
+To create a plotly object, start with `plot_ly()`. Here we turn the `economics` data frame (from the ggplot2 package) into a plotly visualization and store it as the object `p`.
 
 ```{r}
 library(plotly)
@@ -232,7 +232,7 @@ subplot(p2)
   </a>
 </div>
 
-The `subplot()` function creates "xaxis[0-9]" objects which inherit pre-specified properties, but you can also customize each subplot by referencing these objects in the layout
+Part of the magic of `subplot()` is that it generates axis objects with appropriate anchor and domain properties. After generating a subplot, you can always reference these axis objects to customize each plot.
 
 ```{r}
 layout(