Topic/docs understanding api

ML and SO indicate that newbies have trouble understanding the lifted embedding API. This document provides an explanation. This is a draft. It is submitted as a PR just for review not to be merged and against 1.0.1 for because the doctests are currently broken in master.