Api principles (preliminary, very rough draft)

Nicely spotted, although it's probably early to fix typos... I'm bound to make many more.