updated and documented private properties