From e678383172eb652ac5d86d16d59fa1d1027e4843 Mon Sep 17 00:00:00 2001
From: Marcus Ottosson <konstruktion@gmail.com>
Date: Tue, 20 Sep 2016 07:41:41 +0100
Subject: [PATCH] Update README

---
 README.md | 39 +++++++++++++++++++++++++--------------
 1 file changed, 25 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 06bccd8..f12a34a 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,31 @@
 ### Pyblish Starter
 
-Jumpstart your publishing pipeline with a basic configuration.
+A basic publishing pipeline, with batteries included.
 
-> WARNING: This is in development (see latest commit date) and is NOT YET ready for an audience
+> WARNING: Not ready for use.
 
 <br>
 <br>
 
-### Prerequisities
+### Description
 
-- Maya
+Build your own publishing pipeline, starting with the basics.
 
-<br>
-<br>
+**Overview**
+
+This project includes interface and implementation for 3 common types of assets a typical production pipeline.
 
-### Limitations
+- Modeling
+- Rigging
+- Animation
 
-- Doesn't illustrate cross-application features of Pyblish
-- Sandboxed publishing
+The project illustrates how to **(1)** devise a contract - known as a `family` - for each kind of asset and **(2)** design their interface towards each other. For example, it is important for rendering and effects that the normals of each geometric surface is unlocked.
 
-<br>
-<br>
+**Batteries included**
 
-### Features
+In addition to contracts, the project illustrates **boundaries** between publishing and setup. The definition of "setup" being anything that isn't strictly output, such as creating geometry or assigning attributes.
 
-- Asset definition template
-- Versioning
+It includes a series of graphical user interfaces to aid the user in conforming to these contracts. These interfaces represent **placeholders** for your pipeline to fill in; you are invited to either continue from where they finish, or build your own from scratch.
 
 <br>
 <br>
@@ -110,6 +110,10 @@ A generic representation of geometry.
 
 The `starter.rig` contains the necessary implementation and interface for animators to produce 
 
+![aud][] **Target Audience**
+
+- Animation
+
 ![req][] **Requirements**
 
 - Channels in `controls_SEL` at *default* values`*`
@@ -135,6 +139,13 @@ The `starter.rig` contains the necessary implementation and interface for animat
 
 Point positions and normals represented as one Alembic file.
 
+![aud][] **Target Audience**
+
+- Lighting
+- FX
+- Cloth
+- Hair
+
 ![req][] **Requirements**
 
 - [No infinite velocity](#extreme-acceleration) `*`