Card documentation

This merge request intends to start discussing the documentation for the Card component.

#287

contents/components/card.md

@@ -6,16 +6,20 @@ Cards are a flexible component used to display content and actions on a variety
 
 ## Usage
 
-Cards are used to connect similar concepts and/or activities to help make it easier for users to browse, read and learn more about GitLab. The use-cases vary from communicating pricing plans to organising content within issue boards. There are two main types of Cards (Static and Dynamic).
+Cards are used to connect similar concepts and/or activities to help make it easier for users to browse, read and learn more about GitLab. The use-cases vary from communicating pricing plans to organising content within issue boards. 
+
+### Types
+
+There are two main types of Cards: Static and Dynamic.
 
 | Card type | Purpose |
 | --- | --- |
-| Static Card | Single topic component to help compare and contrast similar pieces of information |
-| Dynamic (Draggable Card) | For use in a multidisciplinary list to help users stay organised |
+| Static Card | Single topic component to help compare and contrast similar pieces of information. |
+| Dynamic card | Can be draggable. For use in a multidisciplinary list to help users stay organised. |
 
 ### Alternatives
 
-**Table:** 
+#### Table
 If the purpose of using the component is to compare and contrast 5 or more static (non-draggable) pieces of content a better option would be to structure the data within a [table component](https://design.gitlab.com/components/table).
 
 ## Demo
@@ -46,4 +50,4 @@ This section is **optional**. There should be no more than 3 actions and no fewe
 
 ## Design Specifications
 
-TODO: Add Sketch Measure Preview for List
+TODO: Add Sketch Measure Preview for Cards