documentation parity with ios project (at least wrt public methods)