Add general API design

Several missing sections: VoIP, presence, typing, but many core ordering and event mapping issues are addressed.