Clean up docs a bit

docs/docs/Usage.md

-
 # Usage
 
 - If you don't like reading, just jump into the fully working [playground](https://github.com/wix/react-native-navigation/tree/v2/playground) project. All features are implemented there, and it's the basis for the e2e tests.
 });
 ```
 
-## Layout Examples
-
-The possibilities of the RNN layout API are wide open in terms of what you can construct with it: stacks, tabs and drawers in many combinations.
-
-You can compose arbitrary native layout hierarchies (although some weird edge cases may not be possible or produce errors). In such cases, open an issue so that we either fix it or warn in dev time.
-
-For all possible layout types see [API](/api/README).
-
-
-### Single page app with two side menus:
-
-```js
-Navigation.setRoot({
-  root: {
-    sideMenu: {
-      left: {
-        component: {
-          name: 'navigation.playground.TextScreen',
-          passProps: {
-            text: 'This is a left side menu screen'
-          }
-        }
-      },
-      center: {
-        component: {
-          name: 'navigation.playground.WelcomeScreen'
-        },
-      },
-      right: {
-        component: {
-          name: 'navigation.playground.TextScreen',
-          passProps: {
-            text: 'This is a right side menu screen'
-          }
-        }
-      }
-    }
-  }
-});
-```
-
-### Tab based app (with passProps example):
-
-```js
-Navigation.setRoot({
-  root: {
-    bottomTabs: {
-      children: [
-        {
-          component: {
-            name: 'navigation.playground.TextScreen',
-            passProps: {
-              text: 'This is tab 1',
-              myFunction: () => 'Hello from a function!',
-            },
-          },
-        },
-        {
-          component: {
-            name: 'navigation.playground.TextScreen',
-            passProps: {
-              text: 'This is tab 2',
-            },
-          },
-        },
-      ],
-    },
-  }
-});
-```
-
-### Stack based app (with options example, initialised with 2 screens):
-
-```js
-Navigation.setRoot({
-  root: {
-    stack: {
-      options: {
-        topBar: {
-          hidden: true,
-        },
-      },
-      children: [
-        {
-          component: {
-            name: 'navigation.playground.TextScreen',
-            passProps: {
-              text: 'This is tab 1',
-              myFunction: () => 'Hello from a function!',
-            },
-          },
-        },
-        {
-          component: {
-            name: 'navigation.playground.TextScreen',
-            passProps: {
-              text: 'This is tab 2',
-            },
-          },
-        },
-      ],
-    },
-  }
-});
-```
-
-## Navigating The Stack
-
-For all commands see [API](/api/README).
-
-### push
-Push a new instance of a screen (component) on top of `this` screen's navigation stack.
-
-```js
-Navigation.push(this.props.componentId, {
-  component: {
-    name: 'navigation.playground.PushedScreen'
-  }
-});
-```
-
-### pop
-Pop the top screen from `this` screen's navigation stack.
-
-```js
-Navigation.pop(this.props.componentId);
-```
-
-### showModal
-Show a screen as a modal. (Note: not part of the stack)
-
-```js
-Navigation.showModal({
-  component: {
-    name: 'navigation.playground.ModalScreen'
-  }
-});
-```
-### dismissModal
-Dismiss modal.
-
-```js
-Navigation.dismissModal(this.props.componentId);
-```
-
 ## Screen Lifecycle
 
 The `componentDidAppear` and `componentDidDisappear` functions are special React Native Navigation lifecycle callbacks that are called on the component when it appears and disappears. 

docs/docs/layout-types.md

 # Layout Types
 
+The possibilities of the RNN layout API are wide open in terms of what you can construct with it: stacks, tabs and drawers in many combinations.
+
+You can compose arbitrary native layout hierarchies (although some weird edge cases may not be possible or produce errors). In such cases, open an issue so that we either fix it or warn in dev time.
+
 ## component
 
 Component layout holds a single react component.
 ## stack
 
 Support children layouts of any kind.
-When initialized with more than one screen, the last screen will be presented at the top of the stack.
+A stack can be initialised with more then one screen, in which case the last screen will be presented at the top of the stack.
 
 ```js
 const stack = {
       component: {}
     }
   ],
-  options: {
-
-  }
+  options: {}
 }
 ```
 
 const bottomTabs = {
   children: [
     {
-      stack: {}
+      stack: {
+        children: [],
+        options: {
+          bottomTab: {
+            title: 'Tab 1',
+            icon: require('../images/one.png')
+          }
+        }
+      }
     },
     {
       component: {
-        name: 'tab1',
+        name: 'secondTabScreen',
         options: {
           bottomTab: {
-            icon: require('icon')
+            title: 'Tab 2',
+            icon: require('../images/two.png')
           }
         }
       }
     }
   ],
-  options: {
-
-  }
+  options: {}
 }
 ```
 
     maxWidth: 300, // Maximum width of master view
   },
 }
-```
+```
+
+# Layout Examples
+
+## Single page app with two side menus:
+
+```js
+Navigation.setRoot({
+  root: {
+    sideMenu: {
+      left: {
+        component: {
+          name: 'navigation.playground.TextScreen',
+          passProps: {
+            text: 'This is a left side menu screen'
+          }
+        }
+      },
+      center: {
+        component: {
+          name: 'navigation.playground.WelcomeScreen'
+        },
+      },
+      right: {
+        component: {
+          name: 'navigation.playground.TextScreen',
+          passProps: {
+            text: 'This is a right side menu screen'
+          }
+        }
+      }
+    }
+  }
+});
+```
+
+## Tab based app (with passProps example):
+
+```js
+Navigation.setRoot({
+  root: {
+    bottomTabs: {
+      children: [
+        {
+          component: {
+            name: 'navigation.playground.TextScreen',
+            passProps: {
+              text: 'This is tab 1',
+              myFunction: () => 'Hello from a function!',
+            },
+          },
+        },
+        {
+          component: {
+            name: 'navigation.playground.TextScreen',
+            passProps: {
+              text: 'This is tab 2',
+            },
+          },
+        },
+      ],
+    },
+  }
+});
+```
+
+## Stack based app (with options example, initialised with 2 screens):
+
+```js
+Navigation.setRoot({
+  root: {
+    stack: {
+      options: {
+        topBar: {
+          hidden: true
+        }
+      },
+      children: [
+        {
+          component: {
+            name: 'navigation.playground.TextScreen',
+            passProps: {
+              text: 'This is tab 1',
+              myFunction: () => 'Hello from a function!',
+            }
+          }
+        },
+        {
+          component: {
+            name: 'navigation.playground.TextScreen',
+            passProps: {
+              text: 'This is tab 2',
+            }
+          }
+        }
+      ]
+    }
+  }
+});
+```