diff --git a/core/src/components/item-options/usage/angular.md b/core/src/components/item-options/usage/angular.md
deleted file mode 100644
index 5fa77f601b..0000000000
--- a/core/src/components/item-options/usage/angular.md
+++ /dev/null
@@ -1,12 +0,0 @@
-```html
-<ion-item-sliding>
-  <ion-item>
-    Item 1
-  </ion-item>
-  <ion-item-options side="end" (ionSwipe)="saveItem(item)">
-    <ion-item-option expandable (click)="saveItem(item)">
-      <ion-icon name="star"></ion-icon>
-    </ion-item-option>
-  </ion-item-options>
-</ion-item-sliding>
-```
diff --git a/core/src/components/item-sliding/readme.md b/core/src/components/item-sliding/readme.md
index aa13e42d9c..04c2f24a59 100644
--- a/core/src/components/item-sliding/readme.md
+++ b/core/src/components/item-sliding/readme.md
@@ -1,18 +1,16 @@
 # ion-item-sliding
 
-A Sliding item is a component that contains an item that can be dragged to reveal buttons. It requires an [Item](../Item) component as a child. All options to reveal should be placed in the item options element.
+A sliding item contains an item that can be dragged to reveal buttons. It requires an [item](../item) component as a child. All options to reveal should be placed in the [item options](../item-options) element.
 
-### Direction
 
-By default, the buttons are placed on the `"end"` side. This means that options are revealed when the sliding item is swiped from end to start, i.e. from right to left in LTR, but from left to right in RTL. To place them on the opposite side, so that they are revealed when swiping to the opposite direction, set the `side` attribute to `"start"` on the `ion-item-options` element. Refer to [`ion-item-options` docs](https://github.com/ionic-team/ionic/blob/master/core/src/components/item-options/readme.md). Up to two `ion-item-options` can be used at the same time in order to reveal two different sets of options depending on the swiping direction.
+### Swipe Direction
 
-### Events
+By default, the buttons are placed on the `"end"` side. This means that options are revealed when the sliding item is swiped from end to start, i.e. from right to left in LTR, but from left to right in RTL. To place them on the opposite side, so that they are revealed when swiping in the opposite direction, set the `side` attribute to `"start"` on the [`ion-item-options`]((../item-options) element. Up to two `ion-item-options` can be used at the same time in order to reveal two different sets of options depending on the swiping direction.
 
-It's possible to know the current relative position of the sliding item, add an event listener to the `ionDrag` event.
 
-### Layout
+### Options Layout
 
-By default if an icon is placed with text in the option button, it will display the icon on top of the text.
+By default if an icon is placed with text in the [item option](../item-option), it will display the icon on top of the text, but the icon slot can be changed to any of the following to position it in the option.
 
 | Slot        | description                                                              |
 | ----------- | ------------------------------------------------------------------------ |
@@ -22,10 +20,12 @@ By default if an icon is placed with text in the option button, it will display
 | `bottom`    | The icon is below the text                                               |
 | `end`       | In LTR, end is the right side of the button, and in RTL it is the left   |
 
+
 ### Expandable Options
 
 Options can be expanded to take up the full width of the item if you swipe past a certain point. This can be combined with the `ionSwipe` event to call methods on the class.
 
+
 <!-- Auto Generated Below -->
 
 
diff --git a/core/src/components/item-sliding/usage/angular.md b/core/src/components/item-sliding/usage/angular.md
new file mode 100644
index 0000000000..26d49c0396
--- /dev/null
+++ b/core/src/components/item-sliding/usage/angular.md
@@ -0,0 +1,17 @@
+```html
+<ion-list>
+  <ion-item-sliding>
+    <ion-item>
+      <ion-label>Item</ion-label>
+    </ion-item>
+    <ion-item-options side="start">
+      <ion-item-option (click)="favorite(item)">Favorite</ion-item-option>
+      <ion-item-option color="danger" (click)="share(item)">Share</ion-item-option>
+    </ion-item-options>
+
+    <ion-item-options side="end">
+      <ion-item-option (click)="unread(item)">Unread</ion-item-option>
+    </ion-item-options>
+  </ion-item-sliding>
+</ion-list>
+```