Improve docs for adding speaker notes

exampleSite/content/home/shortcodes/other.md

@@ -2,26 +2,42 @@
 weight = 38
 +++
 
-## Note
+## Notes
 
-Add speaker notes to your presentation with the note shortcode.
+Add speaker notes to your presentation with the `note` shortcode. Type 's' to see this slide's speaker notes.
 
 ```markdown
+---
+
 {{%/* note */%}}
-
+You found the speaker notes!
-Type 's' to see this slide's speaker notes.
-
 {{%/* /note */%}}
+
+---
 ```
 
 {{% note %}}
-
 You found the speaker notes!
-
 {{% /note %}}
 
 ---
 
+{{< slide notes="You found the notes!" >}}
+
+## Notes
+
+You can also add notes with the `slide` shortcode and `notes` attribute:
+
+```markdown
+---
+
+{{%/* slide notes="You found the notes!" */%}}
+
+---
+```
+
+---
+
 <section data-noprocess>
   <h2>Write slides in HTML</h2>
   <p>Use a <code>section</code> tag with a <code>data-noprocess</code> attribute to avoid any processing by reveal-hugo.</p>