Update blog post

hadley · hadley · commit 4b05a3bc334b · 2016-12-30T10:34:43.000-06:00
diff --git a/vignettes/releases/ggplot2-2.2.0.Rmd b/vignettes/releases/ggplot2-2.2.0.Rmd
@@ -21,37 +21,30 @@ knitr::opts_chunk$set(
   fig.retina = NULL
 )
 ```
+<meta charset="utf-8">
 
-I'm planning to release ggplot2 2.2.0 in early November. In preparation, I'd like to announce that a release candidate is now available: version 2.1.0.9001. Please try it out, and file an [issue on GitHub](https://github.com/tidyverse/ggplot2/issues) if you discover any problems. I hope we can find and fix any major issues before the official release.
+I'm very pleased to announce ggplot2 2.2.0. It includes four major new features:
 
-Install the pre-release version with:
+* Subtitles and captions.
+* A large rewrite of the facetting system.
+* Improved theme options.
+* Better stacking.
 
-```{r, eval = FALSE}
-# install.packages("devtools")
-devtools::install_github("tidyverse/ggplot2")
-```
+It also includes as numerous bug fixes and minor improvements, as described in the [release notes](http://github.com/hadley/ggplot2/releases/tag/v2.2.0).
+
+The majority of this work was carried out by [Thomas Pederson](https://github.com/thomasp85), who I was lucky to have as my "ggplot2 intern" this summer. Make sure to check out his other visualisation packages: [ggraph](https://github.com/thomasp85/ggraph), [ggforce](https://github.com/thomasp85/ggforce), and [tweenr](https://github.com/thomasp85/tweenr).
 
-If you discover a major bug that breaks your plots, please [file a minimal reprex](https://github.com/tidyverse/ggplot2/issues), and then roll back to the released version with:
+Install ggplot2 with: 
 
 ```{r, eval = FALSE}
 install.packages("ggplot2")
 ```
 
-ggplot2 2.2.0 will be a relatively major release including:
-
-* Subtitles and captions.
-* A large rewrite of the facetting system.
-* Improved theme options.
-* Better stacking
-* [Numerous bug fixes and minor improvements][news.md].
-
-The majority of this work was carried out by [Thomas Pederson](https://github.com/thomasp85), who I was lucky to have as my "ggplot2 intern" this summer. Make sure to check out other visualisation packages: [ggraph](https://github.com/thomasp85/ggraph), [ggforce](https://github.com/thomasp85/ggforce), and [tweenr](https://github.com/thomasp85/tweenr).
-
 ## Subtitles and captions
 
-Thanks to [Bob Rudis](https://rud.is), you can now add subtitles and captions:
+Thanks to [Bob Rudis](https://rud.is), you can now add subtitles and captions to your plots:
 
-```{r}
+```{r subtitle}
 ggplot(mpg, aes(displ, hwy)) +
   geom_point(aes(color = class)) +
   geom_smooth(se = FALSE, method = "loess") +
@@ -64,44 +57,43 @@ ggplot(mpg, aes(displ, hwy)) +
 
 These are controlled by the theme settings `plot.subtitle` and `plot.caption`.
 
-The plot title is now aligned to the left by default. To return to the previous centering, use `theme(plot.title = element_text(hjust = 0.5))`.
+The plot title is now aligned to the left by default. To return to the previous centered alignment, use `theme(plot.title = element_text(hjust = 0.5))`.
 
 ## Facets
 
-The facet and layout implementation has been moved to ggproto and received a large rewrite and refactoring. This will allow others to create their own facetting systems, as descrbied in the *Extending ggplot2* vignette. Along with the rewrite a number of features and improvements has been added, most notably:
-  
-  * Functions in facetting formulas, thanks to 
+The facet and layout implementation has been moved to ggproto and received a large rewrite and refactoring. This will allow others to create their own facetting systems, as descrbied in the `vignette("extending-ggplot2")`. Along with the rewrite a number of features and improvements has been added, most notably:
+
+*   ou can now use functions in facetting formulas, thanks to 
     [Dan Ruderman](https://github.com/DanRuderman).
-    
-    ```{r}
+  
+    ```{r facet-1}
     ggplot(diamonds, aes(carat, price)) + 
       geom_hex(bins = 20) + 
       facet_wrap(~cut_number(depth, 6))
     ```
 
-  * Axes were dropped when the panels in `facet_wrap()` did not completely 
-    fill the rectangle. Now, an axis is drawn underneath the hanging panels:
+*   Axes are now drawn under the panels in `facet_wrap()` when the 
+    rentangle is not completely filled.
     
-    ```{r}
+    ```{r facet-2}
     ggplot(mpg, aes(displ, hwy)) + 
       geom_point() + 
       facet_wrap(~class)
     ```
 
-  * It is now possible to set the position of the axes through the `position` 
-    argument in the scale constructor:
-    
-    ```{r}
+* You can set the position of the axes with the `position` argument.
+  
+    ```{r facet-3}
     ggplot(mpg, aes(displ, hwy)) + 
       geom_point() + 
       scale_x_continuous(position = "top") + 
       scale_y_continuous(position = "right")
     ```
 
-  * You can display a secondary axis that is a one-to-one transformation of the 
-    primary axis with the `sec.axis` argument:
-    
-    ```{r}
+* You can display a secondary axis that is a one-to-one transformation of
+  the primary axis with `sec.axis`.
+  
+    ```{r facet-4}
     ggplot(mpg, aes(displ, hwy)) + 
       geom_point() + 
       scale_y_continuous(
@@ -110,10 +102,10 @@ The facet and layout implementation has been moved to ggproto and received a lar
       )
     ```
 
-  * Strips can be placed on any side, and the placement with respect to axes
-    can be controlled with the `strip.placement` theme option.
-    
-    ```{r}
+* Strips can be placed on any side, and the placement with respect to axes
+  can be controlled with the `strip.placement` theme option.
+  
+    ```{r facet-5}
     ggplot(mpg, aes(displ, hwy)) + 
       geom_point() + 
       facet_wrap(~ drv, strip.position = "bottom") + 
@@ -127,12 +119,15 @@ The facet and layout implementation has been moved to ggproto and received a lar
 
 ## Theming
 
+*   The `theme()` function now has named arguments so autocomplete
+    and documentation suggestions are vastly improved.
+
 *   Blank elements can now be overridden again so you get the expected 
     behavior when setting e.g. `axis.line.x`. 
     
 *   `element_line()` gets an `arrow` argument that lets you put arrows on axes.
     
-    ```{r}
+    ```{r theme-1}
     arrow <- arrow(length = unit(0.4, "cm"), type = "closed")
     
     ggplot(mpg, aes(displ, hwy)) + 
@@ -144,42 +139,40 @@ The facet and layout implementation has been moved to ggproto and received a lar
     ```
 
 *   Control of legend styling has been improved. The whole legend area can be 
-    aligned according to the plot area and a box can be drawn around all legends:
+    aligned with the plot area and a box can be drawn around all legends:
     
-    ```{r}
+    ```{r theme-2}
     ggplot(mpg, aes(displ, hwy, shape = drv, colour = fl)) + 
       geom_point() + 
       theme(
         legend.justification = "top", 
+        legend.box = "horizontal",
         legend.box.margin = margin(3, 3, 3, 3, "mm"), 
+        legend.margin = margin(),
         legend.box.background = element_rect(colour = "grey50")
       )
     ```
 
 *   `panel.margin` and `legend.margin` have been renamed to `panel.spacing` 
-    and `legend.spacing` respectively as this better indicates their roles.
-    A new `legend.margin` has been actually controls the margin around each 
-    legend.
+    and `legend.spacing` respectively, as this better indicates their roles.
+    A new `legend.margin` actually controls the margin around each legend.
 
-*   When computing the height of titles ggplot2, now inclues the height of the
-    descenders (i.e. the bits `g` and `y` that hang underneath). This makes 
-    improves the margins around titles, particularly the y axis label. I have 
-    also very slightly increased the inner margins of axis titles, and removed 
-    the outer margins. 
+*   When computing the height of titles, ggplot2 now inclues the height of the
+    descenders (i.e. the bits `g` and `y` that hang underneath). This improves
+    the margins around titles, particularly the y axis label. I have also very
+    slightly increased the inner margins of axis titles, and removed the outer
+    margins. 
 
 *   The default themes has been tweaked by 
     [Jean-Olivier Irisson](http://www.obs-vlfr.fr/~irisson/) making them better
     match `theme_grey()`.
 
-*   Lastly, the `theme()` function now has named arguments so autocomplete
-    and documentation suggestions are vastly improved.
-
 ## Stacking bars
   
 `position_stack()` and `position_fill()` now stack values in the reverse 
 order of the grouping, which makes the default stack order match the legend.
 
-```{r}
+```{r stack-1}
 avg_price <- diamonds %>% 
   group_by(cut, color) %>% 
   summarise(price = mean(price)) %>% 
@@ -193,22 +186,43 @@ ggplot(avg_price) +
 (Note also the new `geom_col()` which is short-hand for 
 `geom_bar(stat = "identity")`, contributed by Bob Rudis.)
 
+If you want to stack in the opposite order, try
+[`forcats::fct_rev()`](http://forcats.tidyverse.org/reference/fct_rev.html):
+
+```{r stack-2}
+ggplot(avg_price) + 
+  geom_col(aes(x = cut, y = price, fill = fct_rev(color)))
+```
+
 Additionally, you can now stack negative values:
 
-```{r}
+```{r stack-3}
 ggplot(avg_price) + 
   geom_col(aes(x = cut, y = price_rel, fill = color))
 ```
 
 The overall ordering cannot necessarily be matched in the presence of 
 negative values, but the ordering on either side of the x-axis will match. 
 
-If you want to stack in the opposite order, try
-[`forcats::fct_rev()`](http://forcats.tidyverse.org/reference/fct_rev.html):
+Labels can also be stacked, but the default position is suboptimal:
 
-```{r}
-ggplot(avg_price) + 
-  geom_col(aes(x = cut, y = price, fill = fct_rev(color)))
+```{r stack-4}
+series <- data.frame(
+  time = c(rep(1, 4),rep(2, 4), rep(3, 4), rep(4, 4)),
+  type = rep(c('a', 'b', 'c', 'd'), 4),
+  value = rpois(16, 10)
+)
+
+ggplot(series, aes(time, value, group = type)) +
+  geom_area(aes(fill = type)) +
+  geom_text(aes(label = type), position = "stack")
+```
+
+You can improve the position with the `vjust` parameter. A `vjust` of 0.5 will center the labels inside the corresponding area:
+
+```{r stack-5}
+ggplot(series, aes(time, value, group = type)) +
+  geom_area(aes(fill = type)) +
+  geom_text(aes(label = type), position = position_stack(vjust = 0.5))
 ```
 
-[news.md]: https://github.com/tidyverse/ggplot2/blob/master/NEWS.md
