Api principles (preliminary, very rough draft)

Thanks @Davidslv, I did mean that, and will fix the link.