diff --git a/core/src/components/reorder-group/readme.md b/core/src/components/reorder-group/readme.md
index 7e71c598e2..50212c8a9c 100644
--- a/core/src/components/reorder-group/readme.md
+++ b/core/src/components/reorder-group/readme.md
@@ -1,6 +1,6 @@
 # ion-reorder-group
 
-ReorderGroup is a wrapper component for items with the Reorder element. For more information, see the [Reorder docs](../reorder/)
+The reorder group is a wrapper component for items with the `ion-reorder` component. For more information, see the [Reorder documentation](../reorder/).
 
 <!-- Auto Generated Below -->
 
diff --git a/core/src/components/reorder/readme.md b/core/src/components/reorder/readme.md
index 7cdb5100c2..99ed7b8863 100644
--- a/core/src/components/reorder/readme.md
+++ b/core/src/components/reorder/readme.md
@@ -1,6 +1,6 @@
 # ion-reorder
 
-Reorder is a component that allows an item to be dragged to change it's order. It can be used within an ion-reorder-group to provide a visual drag and drop interface.
+Reorder is a component that allows an item to be dragged to change its order. It can be used within an `ion-reorder-group` to provide a visual drag and drop interface.
 
 
 <!-- Auto Generated Below -->