docs(tab): improve API docs for tab

references #5819

Author: brandyscarney

ionic/components/nav/nav.ts

@@ -20,7 +20,7 @@ import {ViewController} from './view-controller';
  * Nav automatically animates transitions between pages for you.
  *
  * For more information on using navigation controllers like Nav or [Tab](../../Tabs/Tab/),
- * take a look at the [NavController API reference](../NavController/).
+ * take a look at the [NavController API Docs](../NavController/).
  *
  * You must set a root page (where page is any [@Page](../../config/Page/)
  * component) to be loaded initially by any Nav you create, using

ionic/components/tabs/tab.ts

@@ -13,18 +13,18 @@ import {TabButton} from './tab-button';
 /**
  * @name Tab
  * @description
- * _For basic Tabs usage, see the [Tabs section](../../../../components/#tabs)
- * of the Component docs._
+ * The Tab component, written `<ion-tab>`, is styled based on the mode and should
+ * be used in conjunction with the [Tabs](../Tabs/) component.
  *
- * Tab components are basic navigation controllers used with Tabs.  Much like
- * Nav, they are a subclass of NavController and can be used to navigate
- * to pages in and manipulate the navigation stack of a particular tab.
+ * Each tab has a basic navigation controller. Similar to the [Nav](../../nav/Nav/)
+ * component, the tab navigation controller is a subclass of
+ * [NavController](../../nav/NavController). It can be used to navigate and manipulate
+ * pages in the navigation stack of the tab.
  *
  * For more information on using navigation controllers like Tab or [Nav](../../nav/Nav/),
- * take a look at the [NavController API reference](../NavController/).
+ * take a look at the [NavController API Docs](../../nav/NavController/).
  *
- * See the [Tabs API reference](../Tabs/) for more details on configuring Tabs
- * and the TabBar.
+ * See the [Tabs API Docs](../Tabs/) for more details on configuring Tabs.
  *
  * @usage
  * For most cases, you can give tab a `[root]` property along with the component you want to load.
@@ -71,6 +71,10 @@ import {TabButton} from './tab-button';
  *
  *
  * @demo /docs/v2/demos/tabs/
+ * @see {@link /docs/v2/components#tabs Tabs Component Docs}
+ * @see {@link ../../tabs/Tabs Tabs API Docs}
+ * @see {@link ../../nav/Nav Nav API Docs}
+ * @see {@link ../../nav/NavController NavController API Docs}
  */
 @Component({
   selector: 'ion-tab',

ionic/decorators/page.ts

@@ -94,7 +94,7 @@ export interface PageMetadata {
  * you may see these tags if you inspect your markup, you don't need to include
  * them in your templates.
  *
- * For more information on how pages are created, see the [NavController API reference](../../components/nav/NavController/#creating_pages)
+ * For more information on how pages are created, see the [NavController API Docs](../../components/nav/NavController/#creating_pages)
  */
 export function Page(config: PageMetadata) {
   return function(cls) {