improve docs

Author: cpsievert

DESCRIPTION

@@ -72,6 +72,6 @@ Suggests:
     plotlyGeoAssets,
     forcats
 LazyData: true
-RoxygenNote: 6.0.1.9000
+RoxygenNote: 6.1.0
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)

R/style.R

@@ -13,15 +13,30 @@
 #' @export
 #' @examples 
 #' 
-#' p <- qplot(data = mtcars, wt, mpg, geom = c("point", "smooth"))
-#' # keep the hover info for points, but remove it for the line/ribbon
+#' # style() is especially useful in conjunction with ggplotly()
+#' # It allows you to leverage the underlying plotly.js library to change 
+#' # the return result of ggplotly()
+#' (p <- ggplotly(qplot(data = mtcars, wt, mpg, geom = c("point", "smooth"))))
+#' 
+#' # removes hoverinfo for the line/ribbon traces (use `plotly_json()` to verify!)
 #' style(p, hoverinfo = "none", traces = c(2, 3))
 #' 
+#' # another example with plot_ly() instead of ggplotly()
+#' marker <- list(
+#'   color = "red",
+#'   line = list(
+#'     width = 20, 
+#'     color = "black"
+#'  )
+#' )
+#' (p <- plot_ly(x = 1:10, y = 1:10, marker = marker))
+#' 
+#' # note how the entire (marker) object is replaced if a list is provided
+#' style(p, marker = list(line = list(color = "blue")))
 #' 
-#' # to turn the marker's red, without destroying the marker's other properties
+#' # similar to plotly.js, you can update a particular attribute like so 
 #' # https://github.com/plotly/plotly.js/issues/1866#issuecomment-314115744
-#' style(p, marker.color = "red", traces = 1) 
-#' style(p, marker.line.color = "red", traces = 1) 
+#' style(p, marker.line.color = "blue") 
 #' 
 style <- function(p, ..., traces = NULL) {
   p <- plotly_build(p)