Expand opening section of README

README.md

@@ -7,13 +7,12 @@
 [![Code Climate][CC img]][Code Climate]
 [![Awesome][AR img]][Awesome Ruby]
 
-Tabulo is a terminal table generator for Ruby.
+Tabulo is a terminal table generator for Ruby. It is both easy to use, and feature rich.
 
-It offers a DRY, "column-centric" interface, and is designed to make it very easy to produce highly
-readable tables, even from large and unwieldy data sets and streams.
+It offers a DRY, column-based interface, and is designed so that highly readable tables
+can be produced with ease, even from large and unwieldy data sets and streams.
 
-Tabulo is both easy to use and feature rich, allowing you to quickly tabulate any enumerable
-collection, with options for automatic column sizing, a variety of border styles, and more.
+_Quick API:_
 
 ```
 > puts Tabulo::Table.new(User.all, :id, :first_name, :last_name, border: :modern).pack
@@ -25,6 +24,26 @@ collection, with options for automatic column sizing, a variety of border styles
 └────┴────────────┴───────────┘
 ```
 
+_Full API:_
+
+```
+table = Tabulo::Table.new(User.all, border: :modern) do |t|
+  t.add_column("ID", &:id)
+  t.add_column("First name", &:first_name)
+  t.add_column("Last name") { |user| user.last_name.upcase }
+end
+```
+
+```
+> puts table.pack
+┌────┬────────────┬───────────┐
+│ ID │ First name │ Last name │
+├────┼────────────┼───────────┤
+│  1 │ John       │ CITIZEN   │
+│  2 │ Jane       │ DOE       │
+└────┴────────────┴───────────┘
+```
+
 ## Features
 
 * Lets you set [fixed column widths](#fixed-column-widths), then either [wrap](#overflow-handling)