initial api items laid out, docs in progress