initial addition of new API docs - needs further editing