There are 2 open PRs with plenty of documentation text, and we should sort it out before shipping 0.8. I am opening this Issue so that it doesnt get forgotten.
I am asssigning @GreyCat because he seems to be the ultimate authority here and noone else will merge it on his own.