added places documentation and updated documentation