using instance methods; cleaning up documentation