diff --git a/docs/docs/extensions/syntax-for-forms.md b/docs/docs/extensions/syntax-for-forms.md
index 6d769784..5c9328d4 100644
--- a/docs/docs/extensions/syntax-for-forms.md
+++ b/docs/docs/extensions/syntax-for-forms.md
@@ -589,14 +589,14 @@ defaults to `text`.
 
 ![Paragraph Field](../../images/fields/paragraph.png)
 
-The `paragraph` field allows you to display a paragraph of text. The `headline` is optional. There is no `value` for
+The `paragraph` field allows you to display a paragraph of text. The `title` is optional. There is no `value` for
 this field.
 
 ```yaml
   - type: paragraph
     id: paragraph
     attributes:
-      headline: Headline
+      title: Headline
       content: Lorem ipsum dolor sit amet, consetetur sadipscing elitr…
 ```
 
@@ -924,6 +924,7 @@ The `accordion` field can be used to group any number of other fields.
     id: my-accordion
     attributes:
       label: My Accordion
+      icon: gear
     fields:
       - type: boolean
         id: random
@@ -941,7 +942,7 @@ The `accordion` field can be used to group any number of other fields.
       - ...
 ```
 
-The field does not store any values.
+The `icon` attribute can be set to the name of any [Fontawesome icon](https://fontawesome.com/search).  The field does not store any values.
 
 ### Group Field