diff --git a/src/components/grid/col.ts b/src/components/grid/col.ts
index d7e1091919..0f8ddf4bf5 100644
--- a/src/components/grid/col.ts
+++ b/src/components/grid/col.ts
@@ -5,7 +5,8 @@ import { Directive } from '@angular/core';
   * @module ionic
   * @description
   *
-  * Column description
+  * Columns are cellular components of the [grid](../Grid) system and go inside of a [row](../Row).
+  * They will expand to fill their row. All content within a grid should go inside of a column.
   *
   * ## Column attributes
   *
diff --git a/src/components/grid/row.ts b/src/components/grid/row.ts
index 7f7a94bd80..04454868c7 100644
--- a/src/components/grid/row.ts
+++ b/src/components/grid/row.ts
@@ -5,7 +5,8 @@ import { Directive } from '@angular/core';
   * @module ionic
   * @description
   *
-  * Row description
+  * Rows are horizontal components of the [grid](../Grid) system and contain varying numbers of
+  * [columns](../Col). They ensure the columns are positioned properly.
   *
   * ## Row attributes
   *