The I think the section of the docs in question is very unclear, but I think it's an argument for using accessors. For example, provide and use incr_num_holey instead of dealing with $num_holey directly (which you half-do).