fix and unify small issues

functions.qmd

@@ -2,7 +2,7 @@
 
 ## Naming
 
-As well as following the general advice for [object names], strive to use verbs for function names:
+As well as following the general advice for object names in @sec-objectnames, strive to use verbs for function names:
 
 ```{r}
 # Good

ggplot2.qmd

@@ -38,7 +38,8 @@ If the arguments to a ggplot2 layer don't all fit on one line, put each argument
 
 ```{r}
 # Good
-ggplot(aes(x = Sepal.Width, y = Sepal.Length, color = Species)) +
+iris |>
+  ggplot(aes(x = Sepal.Width, y = Sepal.Length, color = Species)) +
   geom_point() +
   labs(
     x = "Sepal width, in cm",
@@ -47,7 +48,7 @@ ggplot(aes(x = Sepal.Width, y = Sepal.Length, color = Species)) +
   )
 
 # Bad
-ggplot(aes(x = Sepal.Width, y = Sepal.Length, color = Species)) +
+iris |> ggplot(aes(x = Sepal.Width, y = Sepal.Length, color = Species)) +
   geom_point() +
   labs(x = "Sepal width, in cm", y = "Sepal length, in cm", title = "Sepal length vs. width of irises")
 ```

pipes.qmd

@@ -4,11 +4,11 @@
 
 Use `|>` to emphasise a sequence of actions, rather than the object that the actions are being performed on.
 
-The tidyverse has been designed to work particuarly well with the pipe, but you can use it with any code, particularly in conjunction with the `_` placeholder.
+The tidyverse has been designed to work particularly well with the pipe, but you can use it with any code, particularly in conjunction with the `_` placeholder.
 
 ```{r}
 strings |>
-  str_replace("a", "b"),
+  str_replace("a", "b") |>
   str_replace("x", "y")
 
 strings |>
@@ -32,12 +32,12 @@ Avoid using the pipe when:
 # Good
 iris |>
   summarize(across(where(is.numeric), mean), .by = Species) |>
-  pivot_longer(-Species, names_to = "measure", values_to = "value") |>
+  pivot_longer(!Species, names_to = "measure", values_to = "value") |>
   arrange(value)
 
 # Bad
 iris |> summarize(across(where(is.numeric), mean), .by = Species) |>
-pivot_longer(-Species, names_to = "measure", values_to = "value") |>
+pivot_longer(!Species, names_to = "measure", values_to = "value") |>
 arrange(value)
 ```
 

syntax.qmd

@@ -1,6 +1,6 @@
 # Syntax
 
-## Object names
+## Object names {#sec-objectnames}
 
 > "There are only two hard things in Computer Science: cache invalidation and
 > naming things."
@@ -157,7 +157,7 @@ There are a few exceptions, which should never be surrounded by spaces:
     x <- 1 : 10
     ```
 
-*   Single-sided formulas when the right-hand side is a single identifier:
+*   Single-sided formulas when the right-hand side is a single identifier.
 
     ```{r}
     # Good
@@ -175,7 +175,7 @@ There are a few exceptions, which should never be surrounded by spaces:
     )
     ```
 
-    Note that single-sided formulas with a complex right-hand side do need a space:
+    Note that single-sided formulas with a complex right-hand side do need a space.
 
     ```{r}
     # Good
@@ -186,7 +186,7 @@ There are a few exceptions, which should never be surrounded by spaces:
     ```
 
 *   When used in tidy evaluation `!!` (bang-bang) and `!!!` (bang-bang-bang)
-    (because have precedence equivalent to unary `-`/`+`)
+    (because they have precedence equivalent to unary `-`/`+`).
 
     ```{r}
     # Good
@@ -198,7 +198,7 @@ There are a few exceptions, which should never be surrounded by spaces:
     call(! !xyz)
     ```
 
-*   The help operator
+*   The help operator.
 
     ```{r}
     # Good