Updated notes to promote encapsulation