Newapi

created a docs directory with new API discussion so we can comment on-line