diff --git a/vignettes/rd-other.Rmd b/vignettes/rd-other.Rmd
index 57993573..7a46fc9a 100644
--- a/vignettes/rd-other.Rmd
+++ b/vignettes/rd-other.Rmd
@@ -22,6 +22,8 @@ knitr::opts_chunk$set(
 Datasets are stored in `data/`, not as regular R objects in the package.
 This means you need to document them in a slightly different way: instead of documenting the data directly, you quote the dataset's name.
 
+For example, this roxygen2 block will documentation for `data(diamonds)`:
+
 ```{r}
 #' Prices of over 50,000 round cut diamonds
 #'