diff --git a/README.md b/README.md
index c20496a..5ecccfa 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,10 @@ Hooks for building **lightweight, fast and extendable datagrids** for React
- Extensible via hooks
- "Why I wrote React Table and the problems it has solved for Nozzle.io" by Tanner Linsley
+## Demos
+
+[React Table v7 Sandbox](https://codesandbox.io/s/m5lxzzpz69)
+
## Versions
- This documentation is for version 7.
@@ -126,37 +130,787 @@ Hooks for building **lightweight, fast and extendable datagrids** for React
-## Table of Contents
-
-- [Installation](#installation)
-- [Example](#examples)
-- [Contributing](#contributing)
-
-## Installation
-
-1. Install React Table as a dependency
-
-```bash
-# Yarn
-$ yarn add react-table
-
-# NPM
-$ npm install react-table
-```
-
-2. Import the `react-table` module
-
-```javascript
-import { useReactTable } from 'react-table'
-```
-
-## Examples
-
-[React Table v7 Sandbox](https://codesandbox.io/s/m5lxzzpz69)
-
# Documentation
-Documentation for v7 is coming soon. If you're looking for the [v6 documentation, click here](https://github.com/tannerlinsley/react-table/tree/v6)
+- [Installation](#installation)
+- [Concepts](#concepts)
+- [Setup](#setup)
+- [Contributing](#contributing)
+
+# Installation
+
+Install React Table as a dependency using `npm` or `yarn`
+
+```bash
+# NPM
+$ npm install react-table
+
+# Yarn
+$ yarn add react-table
+```
+
+To import React Table:
+
+```js
+import {
+ useTable,
+ useColumns,
+ useRows,
+ useGroupBy,
+ useFilters,
+ useSortBy,
+ useExpanded,
+ usePagination,
+ ...
+} from 'react-table'
+```
+
+# Concepts
+
+## React Table is a "headless" library
+
+React Table is a headless utility, which means out of the box, it doesn't render or supply any actual UI elements. You are in charge of utilizing the state and callbacks of the hooks provided by this library to render your own table markup. [Read this article to understand why React Table is built this way.](https://medium.com/merrickchristensen/headless-user-interface-components-565b0c0f2e18). If you don't want to, then here's a quick rundown anyway:
+
+- Separation of Concern - Not that superficial kind you read about all the time. The real kind. React Table as a library honestly has no business being in charge of your UI. The look, feel, and overall experience of your table is what makes your app or product great. The less React Table gets in the way of that, the better!
+- Maintenance - By removing the massive (and seemingly endless) API surface area required to support every UI use-case, React Table can remain small, easy-to-use and simple to update/maintain.
+- Extensibility - UI present countless edge cases for a library simply because it's a creative medium, and one where every developer does things differently. By drawing a line between
+
+## The React Table API
+
+At the heart of every React Table is a table `instance` object. This object contains everything needed to build a table and interact with it's state. This includes, but is not limited to:
+
+- Columns
+- Materialized Data
+- Sorting
+- Filtering
+- Grouping
+- Pagination
+- Expanded State
+- Any functionality provided by custom plugin hooks, too!
+
+## Using Hooks for configuration, state and lifecycle
+
+React Table uses React Hooks both internally and externally for 100% of it's configuration and lifecycle management. Naturally, this is what allows React Table to be headless and lightweight while still having a concise and simple API.
+
+React Table is essentially a compatible collection of **custom React hooks**:
+
+- The primary React Table hook
+ - [`useTable`](#usetable)
+- Plugin Hooks
+ - Required Plugin Hooks
+ - [`useColumns`](#useColumns)
+ - [`useRows`](#useRows)
+ - Core Plugin Hooks
+ - [`useTableState`](#useTableState)
+ - [`useGroupBy`](#useGroupBy)
+ - [`useFilters`](#useFilters)
+ - [`useSortBy`](#useSortBy)
+ - [`useExpanded`](#useExpanded)
+ - [`usePagination`](#usePagination)
+ - [`useTokenPagination`](#useTokenPagination)
+ - Layout Plugin Hooks
+ - [`useFlexLayout`](#useFlexLayout)
+ - [`useAbsoluteLayout`](#useAbsoluteLayout) (coming soon!)
+- Custom Plugin Hooks
+ - Get your custom plugin hook listed here!
+
+### Hook Usage
+
+`useTable` is the **primary** hook used to build a React Table. It serves as the starting point for **every option and every plugin hook** that React Table supports. The options passed into `useTable` are supplied to every plugin hook after it in the order they are supplied, eventually resulting a final `instance` object that you can use to build your table UI and interact with the table's state.
+
+```js
+const instance = useTable(
+ {
+ data: [...],
+ columns: [...],
+ },
+ useColumns,
+ useRows,
+ useGroupBy,
+ useFilters,
+ useSortBy,
+ useExpanded,
+ usePagination
+)
+```
+
+### The stages of a React Table
+
+1. `useTable` is called. A table instance is created.
+1. The `instance.state` is resolved from either a custom user state or an automatically generated one.
+1. A collection of plugin points is created at `instance.hooks`. These plugin points don't run until after all of the plugins have run.
+1. The instance is reduced through each plugin hook in the order they were called. Each hook receives the result of the previous hook, is able to manipulate the `instance`, use plugin points, use their own React hooks internally and eventually return a new one `instance`. This happens until the last instance object is returned from the last hook.
+1. Lastly, the plugin points that were registered and populated during hook reduction are run to produce the final instance object that is returned from `useTable`
+
+This multi-stage process is the secret sauce that allows React Table plugin hooks to work together and compose nicely, while not stepping on each others toes.
+
+### Plugin Hook Order & Consistency
+
+The order and usage of plugin hooks must follow [The Laws of Hooks](TODO), just like any other custom hook. They must always be unconditionally called in the same order.
+
+**Note: In the event that you want to programmatically enable or disable plugin hooks, most of them provide options to disable their functionality, eg. `options.disableSorting`**
+
+### Option Memoization
+
+React Table relies on memoization to determine when state and side effects should update or be calculated. This means that every option you pass to `useTable` should be memoized either via `React.useMemo` (for objects) or `React.useCallback` (for functions).
+
+# React Table Hooks API
+
+## `useTable`
+
+- Required
+
+`useTable` is the root hook for React Table. To use it, call it with an options object, followed by any React Table compatible hooks you want to use.
+
+### Options
+
+- `state: [stateObject, stateUpdater]`
+ - Must be **memoized**
+ - The state/updater pair for the table instance. You would want to override this if you plan on controlling or hoisting table state into your own code.
+ - Defaults to using an internal `useTableState()` instance if not defined.
+ - See [Controlling and Hoisting Table State](#controlling-and-hoistin-table-state)
+- `debug: Bool`
+ - A flag to turn on debug mode.
+ - Defaults to `false`
+
+### Output
+
+- `instance` - The instance object for the React Table
+
+### Example
+
+```js
+const instance = useTable(
+ {
+ // Options
+ },
+ useColumns,
+ useRows,
+ useGroupBy,
+ useFilters,
+ useSortBy,
+ useExpanded,
+ usePagination
+)
+```
+
+## `useColumns`
+
+- Required
+
+`useColumns` is the hook responsible for supporting columns in React Table. It's required for every React Table.
+
+### Options
+
+- `columns: Array`
+ - Required
+ - Must be **memoized**
+ - The core columns configuration object for the entire table.
+
+### Output
+
+The following values are provided to the table `instance`:
+
+- `columns: Array`
+ - A flat array of all final column objects computed from the original columns configuration option.
+- `headerGroups: Array>`
+ - An array of normalized header groups, each containing a flattened array of final column objects for that row.
+- `headers[] Array`
+ - An array of nested final column objects, similar in structure to the original columns configuration option.
+
+### Example
+
+```js
+const myColumns = React.useMemo(
+ () => [
+ {
+ Header: 'Name',
+ columns: [
+ {
+ Header: 'First Name',
+ accessor: 'firstName',
+ },
+ {
+ Header: 'Last Name',
+ accessor: 'lastName',
+ },
+ ],
+ },
+ ],
+ []
+)
+
+const { columns, headerGroups, headers } = useTable(
+ {
+ columns: myColumns,
+ },
+ useColumns
+)
+```
+
+## `useRows`
+
+- Required
+
+`useColumns` is the hook responsible for supporting columns in React Table. It's required for every React Table.
+
+### Options
+
+- `data: Array`
+ - Required
+ - Must be **memoized**
+ - The data array that you want to display on the table.
+- `subRowsKey: String`
+ - Required
+ - Defaults to `subRows`
+ - React Table will use this key when materializing the final row object. It also uses this key to infer sub-rows from the raw data.
+ - See [Grouping and Aggregation](#grouping-and-aggregation) for more information
+
+### Output
+
+The following values are provided to the table `instance`:
+
+- `rows: Array`
+ - An array of rows **materialized** from the original `data` array and `columns` passed into the table options
+
+### Example
+
+```js
+const myColumns = React.useMemo(
+ () => [
+ {
+ Header: 'Name',
+ columns: [
+ {
+ Header: 'First Name',
+ accessor: 'firstName',
+ },
+ {
+ Header: 'Last Name',
+ accessor: 'lastName',
+ },
+ ],
+ },
+ ],
+ []
+)
+
+const data = [
+ {
+ firstName: 'Tanner',
+ lastName: 'Linsley',
+ },
+ {
+ firstName: 'Shawn',
+ lastName: 'Wang',
+ },
+ {
+ firstName: 'Kent C.',
+ lastName: 'Dodds',
+ },
+ {
+ firstName: 'Ryan',
+ lastName: 'Florence',
+ },
+]
+
+const { rows } = useTable(
+ {
+ columns: myColumns,
+ data,
+ },
+ useColumns,
+ useRows
+)
+```
+
+## `useGroupBy`
+
+- Optional
+
+`useGroupBy` is the hook that implements **row grouping and aggregation**.
+
+### Options
+
+- `state[0].groupBy: Array`
+ - Must be **memoized**
+ - An array of groupBy ID strings, controlling which columns are used to calculate row grouping and aggregation. This information is stored in state since the table is allowed to manipulate the groupBy through user interaction.
+- `groupByFn: Function`
+ - Must be **memoized**
+ - Defaults to [`defaultGroupByFn`](TODO)
+ - This function is responsible for grouping rows based on the `state.groupBy` keys provided. It's very rare you would need to customize this function.
+- `manualGroupBy: Bool`
+ - Enables groupBy detection and functionality, but does not automatically perform row grouping. Turn this on if you wish to implement your own row grouping outside of the table (eg. server-side or manual row grouping/nesting)
+- `disableGrouping: Bool`
+ - Disables groupBy for the entire table.
+- `aggregations: Object`
+ - Must be **memoized**
+ - Allows overriding or adding additional aggregation functions for use when grouping/aggregating row values. If an aggregation key isn't found on this object, it will default to using the [built-in aggregation functions](TODO)
+
+### Output
+
+The following values are provided to the table `instance`:
+
+- `rows: Array`
+ - An array of **grouped and aggregated** rows.
+
+### Example
+
+```js
+const state = useTableState({ groupBy: ['firstName'] })
+
+const aggregations = React.useMemo(() => ({
+ customSum: (values, rows) => values.reduce((sum, next) => sum + next, 0),
+}))
+
+const { rows } = useTable(
+ {
+ state, // state[0].groupBy === ['firstName']
+ manualGroupBy: false,
+ disableGrouping: false,
+ aggregations,
+ },
+ useColumns,
+ useRows,
+ useGroupBy
+)
+```
+
+## `useFilters`
+
+- Optional
+
+`useFilters` is the hook that implements **row filtering**.
+
+### Options
+
+- `state[0].filters: