We document both the internal and external APIs, and how they relate to each others. Fixes: #318 Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>